SPLIT

All functions > STRING > SPLIT

Returns an array of substrings from a string split by a delimiter.

Signatures

Returns: Array of substrings

SPLIT(string: VARCHAR, delimiter: VARCHAR, [limit: BIGINT]) → ARRAYVARCHAR
sql
ParameterTypeRequiredDescription
stringVARCHARYesString to split
delimiterVARCHARYesDelimiter to split on
limitBIGINTNoMaximum number of splits (optional)

Notes

  • If delimiter is not found, returns array with original string
  • Empty strings between delimiters are included
  • If limit is specified, splits into at most limit parts
  • With limit, remainder stays together in last element

Examples

FeatureQL
SELECT
    f1 := SPLIT('apple,banana,cherry', ','),  -- Basic split
    f2 := SPLIT('one-two-three', '-'),  -- Dash delimiter
    f3 := SPLIT('hello world', ' '),  -- Space delimiter
    f4 := SPLIT('no delimiter', ',')  -- No delimiter found
;
Result
f1 ARRAYf2 ARRAYf3 ARRAYf4 ARRAY
[apple, banana, cherry][one, two, three][hello, world][no delimiter]

Last update at: 2026/03/03 16:47:38
Last updated: 2026-03-03 16:48:19