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

Apache Doris 中文参考:ARRAY_JOIN

· 52CE 我爱测

将数组中的元素连接成一个字符串。函数会将数组中的所有元素转换为字符串,然后用指定的分隔符连接它们。

array_join

描述

将数组中的元素连接成一个字符串。函数会将数组中的所有元素转换为字符串,然后用指定的分隔符连接它们。

语法

array_join(ARRAY<T> arr, STRING separator [, STRING null_replacement])

参数

  • arr:ARRAY 类型,要连接的数组
  • separator:STRING 类型,必需参数,用于分隔数组元素的分隔符
  • null_replacement:STRING 类型,可选参数,用于替换数组中 null 值的字符串。如果不提供此参数,null 值会被跳过

T 支持的类型:

  • 数值类型:TINYINT、SMALLINT、INT、BIGINT、LARGEINT、FLOAT、DOUBLE、DECIMAL
  • 字符串类型:CHAR、VARCHAR、STRING
  • 日期时间类型:DATE、DATETIME、DATEV2、DATETIMEV2、TIMESTAMP_NS
  • 布尔类型:BOOLEAN
  • IP 类型:IPV4、IPV6
  • UUID:UUID,元素转换为标准文本
  • 复杂类型: ARRAY、MAP、STRUCT

返回值

返回类型:STRING

返回值含义:

  • 返回一个字符串,包含数组中所有元素,用分隔符连接
  • NULL:如果输入数组为 NULL

使用说明:

  • 函数会将数组中的每个元素转换为字符串,元素之间用指定的分隔符连接
  • 对数组元素中的 null 值:
    • 如果提供了 null_replacement 参数,null 元素会被替换为该字符串
    • 如果没有提供 null_replacement 参数,null 元素会被跳过
  • 空数组返回空字符串

查询示例:

使用分隔符连接数组:

SELECT array_join([1, 2, 3, 4, 5], ',');
+--------------------------------------+
| array_join([1, 2, 3, 4, 5], ',')    |
+--------------------------------------+
| 1,2,3,4,5                           |
+--------------------------------------+

使用空格分隔符连接字符串数组:

SELECT array_join(['hello', 'world', 'doris'], ' ');
+--------------------------------------------------+
| array_join(['hello', 'world', 'doris'], ' ')    |
+--------------------------------------------------+
| hello world doris                                |
+--------------------------------------------------+

连接包含 null 的数组(null 值被跳过):

SELECT array_join([1, null, 3, null, 5], '-');
+--------------------------------------------+
| array_join([1, null, 3, null, 5], '-')    |
+--------------------------------------------+
| 1-3-5                                      |
+--------------------------------------------+

使用 null_replacement 参数替换 null 值:

SELECT array_join([1, null, 3, null, 5], '-', 'NULL');
+--------------------------------------------------+
| array_join([1, null, 3, null, 5], '-', 'NULL')  |
+--------------------------------------------------+
| 1-NULL-3-NULL-5                                 |
+--------------------------------------------------+

连接浮点数数组:

SELECT array_join([1.1, 2.2, 3.3], ' | ');
+------------------------------------------+
| array_join([1.1, 2.2, 3.3], ' | ')      |
+------------------------------------------+
| 1.1 | 2.2 | 3.3                         |
+------------------------------------------+

连接日期数组:

SELECT array_join(CAST(['2023-01-01', '2023-06-15', '2023-12-31'] AS ARRAY<DATETIME>), ' to ');
+-----------------------------------------------------------------------------------------+
| array_join(CAST(['2023-01-01', '2023-06-15', '2023-12-31'] AS ARRAY<DATETIME>), ' to ') |
+-----------------------------------------------------------------------------------------+
| 2023-01-01 00:00:00 to 2023-06-15 00:00:00 to 2023-12-31 00:00:00                       |
+-----------------------------------------------------------------------------------------+

连接 IP 地址数组:

SELECT array_join(CAST(['192.168.1.1', '192.168.1.2', '192.168.1.3'] AS ARRAY<IPV4>), ' -> ');
+----------------------------------------------------------------------------------+
| array_join(CAST(['192.168.1.1', '192.168.1.2', '192.168.1.3'] AS ARRAY<IPV4>), ' -> ') |
+----------------------------------------------------------------------------------+
| 192.168.1.1 -> 192.168.1.2 -> 192.168.1.3                                       |
+----------------------------------------------------------------------------------+

空数组返回空字符串:

SELECT array_join([], ',');
+----------------------+
| array_join([], ',')  |
+----------------------+
|                      |
+----------------------+

NULL 数组返回 NULL:

SELECT array_join(NULL, ',');
+----------------------+
| array_join(NULL, ',') |
+----------------------+
| NULL                 |
+----------------------+

传入复杂类型时会报错:

SELECT array_join([{'name':'Alice','age':20}, {'name':'Bob','age':30}], '; ');
ERROR 1105 (HY000): errCode = 2, detailMessage = array_join([map('name', 'Alice', 'age','20'), map('name', 'Bob', 'age','30')], '; ') does not support type: MAP<TEXT,TEXT>

参数数量错误会报错:

SELECT array_join([1,2,3], ',', 'extra', 'too_many');
ERROR 1105 (HY000): errCode = 2, detailMessage = Can not found function 'array_join' which has 4 arity. Candidate functions are: [array_join(Expression, Expression, Expression), array_join(Expression, Expression)]

传入非数组类型时会报错:

SELECT array_join('not_an_array', ',');
ERROR 1105 (HY000): errCode = 2, detailMessage = Can not find the compatibility function signature: array_join(VARCHAR(12), VARCHAR(1))

Keywords

ARRAY, JOIN, ARRAY_JOIN

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

资料来源与适用范围

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

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

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