大网数据广告活动
数据库部署与 SQL 参考

Apache Doris 中文参考:SPLIT/SPLIT_BY_STRING

· 52CE 我爱测

SPLIT_BY_STRING 函数将输入字符串按照指定的分隔符字符串拆分成字符串数组。该函数支持多字符分隔符,与某些数据库的类似函数在空字符串处理上可能存在差异。

描述

SPLIT_BY_STRING 函数将输入字符串按照指定的分隔符字符串拆分成字符串数组。该函数支持多字符分隔符,与某些数据库的类似函数在空字符串处理上可能存在差异。

语法

SPLIT_BY_STRING(<str>, <separator>)

参数

参数 说明
<str> 需要分割的源字符串。类型:VARCHAR
<separator> 用于分割的分隔符字符串。类型:VARCHAR

返回值

返回 ARRAY 类型,包含按分隔符拆分后的字符串数组。

分割规则:

  • 按照 separator 在 str 中出现的位置进行分割
  • 连续的分隔符会产生空字符串元素
  • 字符串开头或结尾的分隔符会产生空字符串元素

特殊情况:

  • 如果任意参数为 NULL,返回 NULL
  • 如果 str 为空字符串,返回空数组 []
  • 如果 separator 为空字符串,str 会按字符进行拆分(每个字符成为数组的一个元素)
  • 如果 separator 在 str 中不存在,返回包含原字符串的数组
  • 如果 str 只包含分隔符,根据分隔符数量返回相应数量的空字符串

示例

  1. 基本字符串分割
SELECT SPLIT_BY_STRING('hello', 'l');
+-------------------------------+
| SPLIT_BY_STRING('hello', 'l') |
+-------------------------------+
| ["he", "", "o"]               |
+-------------------------------+
  1. 空分隔符(按字符分割)
SELECT SPLIT_BY_STRING('hello', '');
+------------------------------+
| SPLIT_BY_STRING('hello', '') |
+------------------------------+
| ["h", "e", "l", "l", "o"]    |
+------------------------------+
  1. 多字符分隔符
SELECT SPLIT_BY_STRING('apple::banana::cherry', '::');
+------------------------------------------------+
| SPLIT_BY_STRING('apple::banana::cherry', '::') |
+------------------------------------------------+
| ["apple", "banana", "cherry"]                  |
+------------------------------------------------+
  1. NULL 值处理
SELECT SPLIT_BY_STRING(NULL, ','), SPLIT_BY_STRING('hello', NULL);
+-----------------------------+----------------------------------+
| SPLIT_BY_STRING(NULL, ',')  | SPLIT_BY_STRING('hello', NULL)   |
+-----------------------------+----------------------------------+
| NULL                        | NULL                             |
+-----------------------------+----------------------------------+
  1. 空字符串处理
SELECT SPLIT_BY_STRING('', ','), SPLIT_BY_STRING('hello', 'xyz');
+---------------------------+----------------------------------+
| SPLIT_BY_STRING('', ',')  | SPLIT_BY_STRING('hello', 'xyz')  |
+---------------------------+----------------------------------+
| []                        | ["hello"]                       |
+---------------------------+----------------------------------+
  1. 连续分隔符
SELECT SPLIT_BY_STRING('a,,b,c', ',');
+-------------------------------+
| SPLIT_BY_STRING('a,,b,c', ',') |
+-------------------------------+
| ["a", "", "b", "c"]           |
+-------------------------------+
  1. 开头和结尾的分隔符
SELECT SPLIT_BY_STRING(',a,b,', ',');
+------------------------------+
| SPLIT_BY_STRING(',a,b,', ',') |
+------------------------------+
| ["", "a", "b", ""]           |
+------------------------------+
  1. 只包含分隔符
SELECT SPLIT_BY_STRING('|||', '|');
+----------------------------+
| SPLIT_BY_STRING('|||', '|') |
+----------------------------+
| ["", "", "", ""]           |
+----------------------------+
  1. UTF-8 字符分割
SELECT SPLIT_BY_STRING('ṭṛì ḍḍumai ṭṛì', ' ');
+--------------------------------------+
| SPLIT_BY_STRING('ṭṛì ḍḍumai ṭṛì', ' ') |
+--------------------------------------+
| ["ṭṛì", "ḍḍumai", "ṭṛì"]              |
+--------------------------------------+
  1. 不存在的分隔符
SELECT SPLIT_BY_STRING('hello world', 'xyz');
+--------------------------------------+
| SPLIT_BY_STRING('hello world', 'xyz') |
+--------------------------------------+
| ["hello world"]                      |
+--------------------------------------+

本文来自 Apache Doris 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
Apache Doris 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。