数组函数

本节提供了 Databend 中数组函数 (Array Functions) 的相关参考信息。数组函数能够创建、操作、搜索和转换数组数据结构。

数组创建与构造

函数	描述	示例
ARRAY_CONSTRUCT	根据单个值创建数组	ARRAY_CONSTRUCT(1, 2, 3) → [1,2,3]
RANGE	生成连续数字序列数组	RANGE(1, 5) → [1,2,3,4]

数组访问与信息

函数	描述	示例
GET	通过索引获取数组元素	GET([1,2,3], 1) → 1
ARRAY_GET	GET 函数的别名	ARRAY_GET([1,2,3], 1) → 1
CONTAINS	检查数组是否包含特定值	CONTAINS([1,2,3], 2) → true
ARRAY_CONTAINS	检查数组是否包含特定值	ARRAY_CONTAINS([1,2,3], 2) → true

数组修改

函数	描述	示例
ARRAY_APPEND	在数组末尾追加元素	ARRAY_APPEND([1,2], 3) → [1,2,3]
ARRAY_PREPEND	在数组开头添加元素	ARRAY_PREPEND(0, [1,2]) → [0,1,2]
ARRAY_INSERT	在指定位置插入元素	ARRAY_INSERT([1,3], 1, 2) → [1,2,3]
ARRAY_REMOVE	移除所有指定元素	ARRAY_REMOVE([1,2,2,3], 2) → [1,3]
ARRAY_REMOVE_FIRST	移除数组首个元素	ARRAY_REMOVE_FIRST([1,2,3]) → [2,3]
ARRAY_REMOVE_LAST	移除数组末尾元素	ARRAY_REMOVE_LAST([1,2,3]) → [1,2]

数组组合与操作

函数	描述	示例
ARRAY_CONCAT	连接多个数组	ARRAY_CONCAT([1,2], [3,4]) → [1,2,3,4]
ARRAY_SLICE	提取数组子集	ARRAY_SLICE([1,2,3,4], 1, 2) → [1,2]
SLICE	ARRAY_SLICE 函数的别名	SLICE([1,2,3,4], 1, 2) → [1,2]
ARRAYS_ZIP	按元素组合多个数组	ARRAYS_ZIP([1,2], ['a','b']) → [(1,'a'),(2,'b')]

数组集合运算

函数	描述	示例
ARRAY_DISTINCT	返回数组唯一元素	ARRAY_DISTINCT([1,2,2,3]) → [1,2,3]
ARRAY_UNIQUE	ARRAY_DISTINCT 函数的别名	ARRAY_UNIQUE([1,2,2,3]) → [1,2,3]
ARRAY_INTERSECTION	返回数组交集元素	ARRAY_INTERSECTION([1,2,3], [2,3,4]) → [2,3]
ARRAY_EXCEPT	返回数组差集元素	ARRAY_EXCEPT([1,2,3], [2,4]) → [1,3]
ARRAY_OVERLAP	检查数组是否存在交集	ARRAY_OVERLAP([1,2,3], [3,4,5]) → true

数组处理与转换

函数	描述	示例
ARRAY_TRANSFORM	对每个元素应用函数	ARRAY_TRANSFORM([1,2,3], x -> x * 2) → [2,4,6]
ARRAY_FILTER	按条件筛选数组元素	ARRAY_FILTER([1,2,3,4], x -> x > 2) → [3,4]
ARRAY_REDUCE	使用聚合函数归约数组	ARRAY_REDUCE([1,2,3], 0, (acc,x) -> acc + x) → 6
ARRAY_AGGREGATE	使用函数聚合数组元素	ARRAY_AGGREGATE([1,2,3], 'sum') → 6

数组工具函数

函数	描述	示例
ARRAY_COMPACT	移除数组中的空值（null）	ARRAY_COMPACT([1,null,2,null,3]) → [1,2,3]
ARRAY_FLATTEN	展平嵌套数组	ARRAY_FLATTEN([[1,2],[3,4]]) → [1,2,3,4]
ARRAY_REVERSE	反转数组元素顺序	ARRAY_REVERSE([1,2,3]) → [3,2,1]
ARRAY_INDEXOF	返回元素首次出现的索引	ARRAY_INDEXOF([1,2,3,2], 2) → 1
UNNEST	将数组展开为独立行	UNNEST([1,2,3]) → 1, 2, 3 (作为独立行)