文档中心

日志服务

SQL 函数

数组函数

本文介绍日志服务支持的数组函数语法及常见场景的使用示例。

函数列表

说明

在日志服务分析语句（SQL 语句）中，需要使用单引号（''）包裹代表字符串的字符，无符号包裹或被双引号（""）包裹的字符为字段名或列名。例如'time' 代表字符串，time 或 "time" 代表字段名或列名。

函数名称	函数语法	说明
下标运算符	[x]	返回数组中第 x 个元素。
ARRAY_AGG 函数	ARRAY_AGG(KEY)	聚合目标字段或表达式的值，并以数组形式返回。
ARRAY_DISTINCT 函数	ARRAY_DISTINCT(KEY)	删除数组中重复的元素。
ARRAY_EXCEPT 函数	ARRAY_EXCEPT(KEY1, KEY2)	剔除两个数组中的重复元素，并返回被剔除重复元素后的第一个数组。
ARRAY_INTERSECT 函数	ARRAY_INTERSECT(KEY1, KEY2)	返回两个数组的交集。
ARRAY_JOIN 函数	ARRAY_JOIN(KEY, delimiter)	使用指定的连接符将数组中的元素拼接为一个字符串。如果数组中包含 NULL 元素，则忽略 NULL 元素。
ARRAY_JOIN 函数		ARRAY_JOIN(KEY, delimiter, null_replacement)	使用指定的连接符将数组中的元素拼接为一个字符串。如果数组中包含 NULL 元素，则指定其他字符串代替 NULL 元素。
ARRAY_MAX 函数	ARRAY_MAX(KEY)	计算数组元素中的最大值。
ARRAY_MIN 函数	ARRAY_MIN(KEY)	计算数组元素中的最小值。
ARRAY_POSITION 函数	ARRAY_POSITION(KEY, element)	查找指定元素的位置，元素索引从 1 开始。
ARRAY_REMOVE 函数	ARRAY_REMOVE(KEY, element)	删除数组中的某个元素。
ARRAY_SORT 函数	ARRAY_SORT(KEY)	对数组中的元素进行升序排序。如果存在 NULL 元素，则将 NULL 元素排在最后。
ARRAY_TRANSPOSE 函数	ARRAY_TRANSPOSE(KEY)	对数组进行转置操作，提取二维数组中索引相同的元素组成一个新的二维数组。
ARRAY_UNION 函数	ARRAY_UNION(KEY1, KEY2)	返回两个数组的并集。
CARDINALITY 函数	CARDINALITY(KEY)	统计数组中元素的个数。
CONCAT 函数	CONCAT(KEY1, KEY2…)	拼接多个数组为一个数组。
CONTAINS 函数	CONTAINS(KEY, element)	判断数组中是否包含某个元素。
ELEMENT_AT 函数	ELEMENT_AT(KEY, index)	获取数组中指定位置的元素。
FLATTEN 函数	FLATTEN(KEY)	将二维数组转换为一维数组。
FILTER 函数	FILTER(KEY, lambda_expression)	结合 FILTER 函数和 Lambda 表达式，用于过滤数组中的元素。
REDUCE 函数	REDUCE(KEY, lambda_expression)	根据 Lambda 表达式中的定义，对数组中的各个元素进行累积计算，然后返回计算结果。
REVERSE 函数	REVERSE(KEY)	对数组中的元素进行反向排列。
SEQUENCE 函数	SEQUENCE(x, y)	生成指定范围内的数组，其元素为起止值范围内一组连续且递增的值。其中，递增间隔为默认值 1。
SEQUENCE 函数		SEQUENCE(x, y, step)	生成指定范围内的数组，其元素为起止值范围内一组连续且递增的值。其中，递增间隔为自定义值。
SHUFFLE 函数	SHUFFLE(KEY)	对数组元素进行随机重新排列。
SLICE 函数	SLICE(KEY, start, length)	获取数组的子集。
TRANSFORM 函数	TRANSFORM(KEY, lambda_expression)	将 Lambda 表达式应用到数组的每个元素中。
ZIP 函数	zip(KEY1, KEY2...)	将多个数组按照对应位置组合为一个二维数组，各个数组中下标相同的元素组成一个新的数

下标运算符

下标运算符用于返回数组中第 x 个元素。等同于 ELEMENT_AT 函数。

函数语法

语法格式

参数说明

参数
说明
x
指定待获取元素的索引，从 1 开始。值为 Bigint 类型。

返回值说明

返回值与指定元素的数据类型一致。

函数示例

场景

返回数组 [5.0,20.0,39.0, 1, 7] 中的第 1 个元素。

检索和分析语句

* | SELECT array[5.0,20.0,39.0,1,7][1]

检索和分析结果

ARRAY_AGG 函数

ARRAY_AGG 函数用于聚合一组值，并以数组形式返回。

函数语法

语法格式

ARRAY_AGG (KEY)

参数说明

参数
说明
KEY
字段、表达式，其值为任意数据类型。

返回值说明

返回值为 Array 类型。

函数示例

场景

聚合 test_double 字段的值，并以数组形式返回。

日志样例

检索和分析语句

* | SELECT ARRAY_AGG(test_double) AS array

检索和分析结果

ARRAY_DISTINCT 函数

ARRAY_DISTINCT 函数用于删除重复的数组元素。

函数语法

语法格式

ARRAY_DISTINCT(KEY)

参数说明

参数
说明
KEY
字段、表达式，其值为任意数据类型。

返回值说明

返回值为 Array 类型。

函数示例

场景

删除test_text字段值中重复的元素。

日志样例

检索和分析语句

*| SELECT ARRAY_DISTINCT(cast(JSON_PARSE(test_text) as array(bigint)))

检索和分析结果

ARRAY_EXCEPT 函数

ARRAY_EXCEPT 函数用于删除两个数组中的重复元素，并返回被删除重复元素后的第一个数组。

函数语法

语法格式

ARRAY_EXCEPT(KEY1, KEY2)

参数说明

参数
说明
KEY
字段、表达式，其值为 Array 类型。

返回值说明

返回值为 Array 类型。

函数示例

场景

删除数组[10,2,30,14,5]和[4,2,5,7]中的重复元素2、5，然后返回第一个数组[10,30,14]。

检索和分析语句

* | SELECT ARRAY_EXCEPT(array[10,2,30,14,5],array[4,2,5,7])

检索和分析结果

ARRAY_INTERSECT 函数

ARRAY_INTERSECT 函数用于返回两个数组的交集。

函数语法

语法格式

ARRAY_INTERSECT(KEY1, KEY2)

参数说明

参数
说明
KEY
字段、表达式，其值为 Array 类型。

返回值说明

返回值为 Array 类型。

函数示例

场景

计算数组[10,2,30,14,5]和[4,2,5,7]的交集。

检索和分析语句

* | SELECT ARRAY_INTERSECT(array[10,2,30,14,5],array[4,2,5,7])

检索和分析结果

ARRAY_JOIN 函数

ARRAY_JOIN 函数用于将数组元素拼接为一个字符串。

函数语法

语法格式

使用指定的连接符将数组元素拼接为一个字符串。如果数组中包含 NULL 元素，则忽略 NULL 元素。

ARRAY_JOIN(KEY, delimiter)

使用指定的连接符将数组元素拼接为一个字符串。如果数组中包含 null 元素，则指定其他字符串代替 null 元素。

ARRAY_JOIN(KEY, delimiter,null_replacement)

参数说明

参数
说明
KEY
字段、表达式，其值为 Array 类型。
delimiter
连接符，可以为字符串。
null_replacement
用于替换 NULL 元素的字符串。

返回值说明

返回值为 Varchar 类型。

函数示例

场景

使用空格将数组 [null, 'Hello','World'] 中的元素拼接为一个字符串，并使用Replace替换 null 元素。

检索和分析语句

* | SELECT ARRAY_JOIN(array[null,'Hello','World'],' ','Replace')

检索和分析结果

ARRAY_MAX 函数

ARRAY_MAX 函数用于提取数组元素中的最大值。

函数语法

语法格式

ARRAY_MAX(KEY)

参数说明

参数
说明
KEY
字段、表达式，其值为任意数据类型。

返回值说明

返回值与数组元素的数据类型一致。如果数组中包含 NULL，则返回结果为 NULL。

函数示例

场景

提取 test_text 字段值中的最大值。

日志样例

检索和分析语句

*| SELECT ARRAY_MAX(TRY_CAST(JSON_PARSE(test_text) as ARRAY(bigint))) AS max_number

检索和分析结果

ARRAY_MIN 函数

ARRAY_MIN 函数用于提取数组元素中的最小值。

函数语法

语法格式

ARRAY_MIN(KEY)

参数说明

参数
说明
KEY
字段、表达式，其值为任意数据类型。

返回值说明

返回值与数组元素的数据类型一致。如果数组中包含 NULL，则返回结果为 NULL。

函数示例

场景

计算 test_text 字段值中的最小值。

日志样例

检索和分析语句

*| SELECT ARRAY_MIN(try_cast(JSON_PARSE(test_text) as array(bigint))) AS min_number

检索和分析结果

ARRAY_POSITION 函数

ARRAY_POSITION 函数用于查找指定元素的位置，元素索引从 1 开始。

函数语法

语法格式

ARRAY_POSITION(KEY, element)

参数说明

参数
说明
KEY
字段、表达式，其值为 Array 类型。
element
数组中的一个元素。

返回值说明

返回值为 Bigint 类型。如果元素为 null ，则返回结果也为 null ；如果元素不存在，则返回 0。

函数示例

场景

查找数组 [23,94,18,66] 中元素 18 的位置。

检索和分析语句

* | SELECT ARRAY_POSITION(array[23,94,18,66],18)

检索和分析结果

ARRAY_REMOVE 函数

ARRAY_REMOVE 函数用于删除指定的数组元素。

函数语法

语法格式

ARRAY_REMOVE(KEY, element)

参数说明

参数
说明
KEY
字段、表达式，其值为 Array 类型。
element
数组中的一个元素。

返回值说明

返回值为 Array 类型。如果待删除的元素为 null ，则返回结果也为 null。

函数示例

场景

删除数组[49,45,47]中的 45。

检索和分析语句

* | SELECT ARRAY_REMOVE(array[49,45,47],45)

检索和分析结果

ARRAY_SORT 函数

ARRAY_SORT 函数按照升序对数组元素进行排列。如果存在 NULL 元素，则将 NULL 元素排在最后。

函数语法

语法格式

ARRAY_SORT(KEY)

参数说明

参数
说明
KEY
字段、表达式，其值为 Array 类型。

返回值说明

返回值为 Array 类型。

函数示例

场景

对数组['e', 'k', null, 'v', 'y']进行升序排序。

检索和分析语句

* | SELECT ARRAY_SORT(ARRAY['e', 'k', null, 'v', 'y'])

检索和分析结果

ARRAY_TRANSPOSE 函数

ARRAY_TRANSPOSE 函数用于对数组进行转置操作，提取二维数组中索引相同的元素组成一个新的二维数组。

函数语法

语法格式

ARRAY_TRANSPOSE(KEY)

参数说明

参数
说明
KEY
字段、表达式，其值为 Array(double) 类型。

返回值说明

返回值为 Array(double) 类型。

函数示例

场景

提取数组 [5,3,7,1]、[20,39,189,117]、[39,85,27] 中索引都为 1 的元素 5、20、39 ，组成数组 [5.0,20.0,39.0]；提取数组 [5,3,7,1]、[20,39,189,117]、[39,85,27] 中索引都为 2 的元素 3、39、85，组成数组 [3.0,39.0,85.0]；以此类推，组成一个新的二维数组。

检索和分析语句

* | SELECT ARRAY_TRANSPOSE(array[array[5,3,7,1],array[20,39,189,117],array[39,85,27]])

检索和分析结果

ARRAY_UNION 函数

ARRAY_UNION 函数用于计算两个数组的并集。

函数语法

语法格式

ARRAY_UNION(KEY1, KEY2)

参数说明

参数
说明
KEY
字段、表达式，其值为 Array 类型。

返回值说明

返回值为 Array 类型。

函数示例

场景

计算数组[10,2,30,14,5]和[4,2,5,7]的并集。

检索和分析语句

* | SELECT ARRAY_UNION(ARRAY[10,2,30,14,5],ARRAY[4,2,5,7])

检索和分析结果

CARDINALITY 函数

CARDINALITY 函数用于统计数组元素的个数。

函数语法

语法格式

CARDINALITY(KEY)

参数说明

参数
说明
KEY
字段、表达式，其值为 Array 类型。

返回值说明

返回值为 Bigint 类型。

函数示例

场景

计算 test_text 字段值中元素的个数。

日志样例

检索和分析语句

*| SELECT CARDINALITY(CAST(JSON_PARSE(test_text) as ARRAY(bigint)))

检索和分析结果

CONCAT 函数

CONCAT 函数用于拼接多个数组为一个数组。

函数语法

语法格式

CONCAT(KEY1, KEY2…)

参数说明

参数
说明
KEY
字段、表达式，其值为 Array 类型。

返回值说明

返回值为 Array 类型。

函数示例

场景

将数组 [10,2,30,14,5] 和 [4,2,5,7] 拼接为一个数组。

检索和分析语句

* | SELECT CONCAT(ARRAY[10,2,30,14,5],ARRAY[4,2,5,7])

检索和分析结果

CONTAINS 函数

CONTAINS 函数用于判断数组是否包含某个元素。

函数语法

语法格式

CONTAINS(KEY, element)

参数说明

参数
说明
KEY
字段、表达式，其值为 Array 类型。
element
数组元素。

返回值说明

返回值为 Boolean 类型。如果数组中包含某个元素，则返回 true，否则反正 false。

函数示例

场景

计算 test_text 字段值中是否包含 50。

日志样例

检索和分析语句

*| SELECT CONTAINS(cast(JSON_PARSE(test_text) as array(bigint)), 50)

检索和分析结果

ELEMENT_AT 函数

ELEMENT_AT 函数用于获取数组中指定位置的元素。

函数语法

语法格式

ELEMENT_AT(KEY, index)

参数说明

参数
说明
KEY
字段、表达式，其值为 Array 类型。
index
指定待获取元素的索引，从 1 开始。值为 Bigint 类型。

返回值说明

返回值为任意数据类型。

函数示例

场景

返回数组 [5.0,20.0,39.0, 1, 7] 中的第 3 个元素。

检索和分析语句

* | SELECT ELEMENT_AT(array[5.0,20.0,39.0, 1, 7], 3)

检索和分析结果

FILTER 函数

结合 FILTER 函数和 Lambda 表达式，过滤数组中的元素。

函数语法

语法格式

FILTER(KEY, lambda_expression)

参数说明

参数
说明
KEY
字段、表达式，其值为 Array 类型。
lambda_expression
Lambda 表达式。

返回值说明

返回值为 Array 类型。返回的数组中只包含满足 Lambda 表达式的元素。

函数示例

场景

结合 Lambda 表达式 x -> x > 0，返回数组 [10,-1,null,9,-7] 中大于 0 的元素。

检索和分析语句

* | SELECT FILTER(array[10,-1,null,9,-7],x -> x > 0)

检索和分析结果

FLATTEN 函数

FLATTEN 函数用于将二维数组转换为一维数组。

函数语法

语法格式

FLATTEN(KEY)

参数说明

参数
说明
KEY
字段、表达式，其值为 Array 类型。

返回值说明

返回值为 Array 类型。

函数示例

场景

将二维数组 array[array[3,9,4,8,0],array[9,9,7,4,1]] 转换为一维数组。

检索和分析语句

* | SELECT FLATTEN(array[array[3,9,4,8,0],array[9,9,7,4,1]])

检索和分析结果

REDUCE 函数

REDUCE 函数将根据 Lambda 表达式中的定义，对数组中的各个元素进行累积计算，然后返回计算结果。

函数语法

语法格式

REDUCE(KEY, lambda_expression)

参数说明

参数	说明
KEY	字段、表达式，其值为 Array 类型。
lambda_expression	第一个参数是初始值，第二个参数是 Lambda 表达式，第三个参数是对 Lambda 表达式计算结果的处理。

返回值说明

返回值为 Bigint 类型。

函数示例

场景

返回数组 ['hello', 'world', '!'] 中各个元素连接后的结果。

检索和分析语句

* | SELECT REDUCE(array['hello', 'world', '!'],'',(s, x) -> s || ' ' || x, s -> s)

检索和分析结果

REVERSE 函数

REVERSE 函数用于反向排列数组元素。

函数语法

语法格式

REVERSE(KEY)

参数说明如下：

参数
说明
KEY
字段、表达式，其值为 Array 类型。

返回值说明

返回值为 Array 类型。

函数示例

场景

将数组[100,500,300,400,200]中的元素反向排序。

检索和分析语句

* | SELECT REVERSE(array[100,500,300,400,200])

检索和分析结果

SEQUENCE 函数

SEQUENCE 函数用于生成指定范围内的数组，其元素为指定范围内一组连续且递增的值。

函数语法

语法格式

递增间隔为默认值 1。

SEQUENCE(x, y)

自定义递增间隔。

SEQUENCE(x, y, step)

参数说明

参数	说明
x	字段、表达式，其值为 Bigint类型、Timestamp类型（Unix时间戳、日期和时间表达式）。
y	字段、表达式，其值为 Bigint类型、Timestamp类型（Unix时间戳、日期和时间表达式）。
step	数值间隔。当参数值为日期和时间表达式时，step 格式如下： interval 'n' year to month，表示间隔为 n 年。 interval 'n' day to second，表示间隔为 n 天。

返回值说明

返回值为 Array 类型。

函数示例

场景1：返回 1~9 之间的基数序列。

检索和分析语句

* | SELECT SEQUENCE(1,9,2)

检索和分析结果

场景2：生成 2024-08-01 到 2024-08-25 之间的日期序列，间隔为 3 天。

检索和分析语句

* | SELECT SEQUENCE (FROM_UNIXTIME(1722441600),FROM_UNIXTIME(1724515200),interval '3' day )

检索和分析结果

场景3：返回 1722441600 到 1724515200 之间的 Unix 时间戳，间隔为 3 天。

检索和分析语句

* | SELECT sequence(1722441600,1724515200,3 * 24 * 60 * 60)

检索和分析结果

SHUFFLE 函数

SHUFFLE 函数用于对数组元素进行随机重新排列。

函数语法

语法格式

SHUFFLE(KEY)

参数说明

参数
说明
KEY
字段、表达式，其值为 Array 类型。

返回值说明

返回值为 Array 类型。

函数示例

场景

对数组 [99,87,16,43,25] 中的元素进行随机重新排序。

检索和分析语句

*| SELECT SHUFFLE(array[99,87,16,43,25])

检索和分析结果

SLICE 函数

SLICE 函数用于获取数组的子集。

函数语法

语法格式

SLICE(KEY, start, length)

参数说明

参数	说明
KEY	字段、表达式，其值为 Array 类型。
start	指定索引开始的位置。如果 start 为负数，则从末尾开始。如果 start 为正数，则从头部开始。
length	指定子集中元素的个数。

返回值说明

返回值为 Array 类型。

函数示例

场景

返回数组 [99,87,16,43,25] 的子集，从第 2 个元素开始返回，子集元素个数为 3。

检索和分析语句

* | SELECT SLICE(array[99,87,16,43,25],2,3)

检索和分析结果

TRANSFORM 函数

TRANSFORM 函数用于将 Lambda 表达式应用到数组的每个元素中。

函数语法

语法格式

TRANSFORM(KEY, lambda_expression)

参数说明

参数
说明
KEY
字段、表达式，其值为 Array 类型。
lambda_expression
Lambda 表达式。

返回值说明

返回值为 Array 类型。

函数示例

场景

将数组 [99,87,16,43,25] 中的各个元素乘以 2，然后返回计算结果。

检索和分析语句

* | SELECT TRANSFORM(array[99,87,16,43,25],x -> x * 2)

检索和分析结果

ZIP 函数

ZIP 函数用于将多个数组按照对应位置组合为一个二维数组，各个数组中索引相同的元素组成一个新的数组。

函数语法

语法格式

zip(KEY1, KEY2...)

参数说明

参数
说明
KEY
字段、表达式，其值为 Array 类型。

返回值说明

返回值为 Array 类型。

函数示例

场景

将数组 [7,1,9]、['hello','world','!'] 和 [99,87,16] 合并为一个二维数组。

检索和分析语句

* | SELECT ZIP(array[7,1,9], array['hello','world','!'],array[99,87,16])

检索和分析结果

最近更新时间：2026.08.28 16:45:49

这个页面对您有帮助吗？

有用

无用

参数	说明
x	指定待获取元素的索引，从 1 开始。值为 Bigint 类型。

参数	说明
KEY	字段、表达式，其值为任意数据类型。

参数	说明
KEY	字段、表达式，其值为 Array(double) 类型。