类别：: /sql-reference/functions-string`（常规）、 :doc:/sql-reference/functions-semistructured`（转换/类型转换）

STRTOK_TO_ARRAY¶

将给定字符串按照指定的一组分隔符进行分词，并以 ARRAY 的形式返回这些词元。

语法¶

STRTOK_TO_ARRAY( <string> [ , <delimiter> ] )

实参¶

必填：

string: 要标记化的文本。

可选：

delimiter

一组分隔符。

默认值：单个空格字符。

返回¶

此函数返回 ARRAY 类型的值或 NULL。

如果令牌化不产生任何令牌，则该函数返回一个空数组。

如果任一实参为 NULL 或 JSON null 值，则该函数返回 NULL。

示例¶

以下示例使用 STRTOK_TO_ARRAY 函数将字符串拆分为数组：

SELECT STRTOK_TO_ARRAY('a.b.c', '.') AS string_to_array;

+-----------------+
| STRING_TO_ARRAY |
|-----------------|
| [               |
|   "a",          |
|   "b",          |
|   "c"           |
| ]               |
+-----------------+

此示例使用多个分隔符（. 和 @）进行令牌化。

SELECT STRTOK_TO_ARRAY('user@snowflake.com', '.@') AS multiple_delimiters;

+---------------------+
| MULTIPLE_DELIMITERS |
|---------------------|
| [                   |
|   "user",           |
|   "snowflake",      |
|   "com"             |
| ]                   |
+---------------------+