数组函数
本文介绍数组函数的语法规则，包括参数解释、函数示例等。
函数列表
函数 |
描述 |
|---|---|
将输入的参数构造成数组，参数类型必须相同。 |
|
获取指定元素的下标，下标从1开始。如果指定元素不存在，则返回0。 |
|
计算数组中元素的个数。 |
|
计算数组中元素的个数， 同cardinality。 |
|
判断数组中是否包含指定元素。如果包含，则返回true。 |
|
判断数组中是否包含指定元素。如果包含，则返回true，同contains。 |
|
将指定的元素添加到数组的开始位置。 |
|
将指定的元素添加到数组的末尾。 |
|
返回从start到end索引的数组。 |
|
通过str指定分隔符连接arr所有元素。 |
|
使用指定的分隔符str2将str1拆分为数组 |
|
返回所提供的基于0的索引处的数组元素，或对于超出范围的索引返回null。 |
|
返回所提供的基于1的索引处的数组元素，或对于超出范围的索引返回null。 |
|
返回数组中第一次出现expr的基于0的索引，如果未出现，则返回-1。 |
|
返回数组中第一次出现expr的基于1的索引，如果未出现，则返回-1。 |
array函数
将参数构建成数组，参数类型必须相同。
语法：array(expr1,expr ...)
参数名称 |
描述 |
类型 |
是否必选 |
|---|---|---|---|
expr |
原始数据 |
String/Integer/Long/Double/Float |
是 |
返回值类型：Array类型
示例：SELECT ARRAY('1','2','3','4','5')
类型 |
场景 |
|---|---|
查询语句 |
ARRAY('1','2','3','4','5') |
返回结果 |
["1", "2", "3", "4", "5"] |
array_position函数
获取指定元素的下标，下标从1开始。如果指定元素不存在，则返回0。
语法：array_position(expr, ele)
参数名称 |
描述 |
类型 |
是否必选 |
|---|---|---|---|
expr |
原始数组 |
Array（String/Number） |
是 |
ele |
指定的元素 |
String/Number |
是 |
返回值类型：Integer类型
示例：SELECT ARRAY_POSITION(ARRAY('1','2','3'),'2')
类型 |
场景 |
|---|---|
查询语句 |
ARRAY_POSITION(ARRAY('1','2','3'),'2') |
返回结果 |
2 |
cardinality函数
计算数组中元素的个数。
语法：cardinality(expr)
参数名称 |
描述 |
类型 |
是否必选 |
|---|---|---|---|
expr |
原始数组 |
Array（String/Number） |
是 |
返回值类型：String类型
示例：SELECT CARDINALITY(ARRAY('1','2','3'))
类型 |
场景 |
|---|---|
查询语句 |
CARDINALITY(ARRAY('1','2','3')) |
返回结果 |
3 |
mv_length函数
计算数组中元素的个数， 同cardinality。
语法：mv_length(expr)
参数名称 |
描述 |
类型 |
是否必选 |
|---|---|---|---|
expr |
原始数组 |
Array（String/Number） |
是 |
返回值类型：Integer
示例：SELECT MV_LENGTH(ARRAY('1','2','3'))
类型 |
场景 |
|---|---|
查询语句 |
MV_LENGTH (ARRAY('1','2','3')) |
返回结果 |
3 |
contains函数
判断数组中是否包含指定元素。如果包含，则返回true。
语法：contains(expr, ele)
参数名称 |
描述 |
类型 |
是否必选 |
|---|---|---|---|
expr |
原始数组 |
Array（String/Number） |
是 |
ele |
指定的元素 |
String/Number |
是 |
返回值类型：Boolean类型
示例：SELECT CONTAINS(ARRAY('1','2'),'1')
类型 |
场景 |
|---|---|
查询语句 |
CONTAINS(ARRAY('1','2'),'1') |
返回结果 |
true |
mv_contains函数
判断数组中是否包含指定元素。如果包含，则返回true，同contains。
语法：mv_contains(expr, ele)
参数名称 |
描述 |
类型 |
是否必选 |
|---|---|---|---|
expr |
原始数组 |
Array（String/Number） |
是 |
ele |
指定的元素 |
String/Number |
是 |
返回值类型：Boolean类型
示例：SELECT MV_CONTAINS(ARRAY('1','2'),'1')
类型 |
场景 |
|---|---|
查询语句 |
MV_CONTAINS(ARRAY('1','2'),'1') |
返回结果 |
true |
mv_prepend函数
将指定的元素添加到数组的开始位置。
语法：mv_prepend(expr, arr)
参数名称 |
描述 |
类型 |
是否必选 |
|---|---|---|---|
expr |
指定的元素 |
String/Number |
是 |
arr |
原始数组 |
Array（String/Number） |
是 |
返回值类型：Array类型
示例：SELECT MV_PREPEND('1', ARRAY ('1','2'))
类型 |
场景 |
|---|---|
查询语句 |
MV_PREPEND ('1', ARRAY ('1','2')) |
返回结果 |
["1","1","2"] |
mv_append函数
将指定的元素添加到数组的末尾。
语法：mv_append(arr, expr)
参数名称 |
描述 |
类型 |
是否必选 |
|---|---|---|---|
arr |
原始数组 |
Array（String/Number） |
是 |
expr |
指定的元素 |
String/Number |
是 |
返回值类型：Array类型
示例：SELECT MV_APPEND(ARRAY('1','2'),'1')
类型 |
场景 |
|---|---|
查询语句 |
MV_APPEND(ARRAY('1','2'), '1') |
返回结果 |
["1","2","1"] |
mv_slice函数
返回从start到end索引的数组。
语法：mv_slice(arr, start, end)
参数名称 |
描述 |
类型 |
是否必选 |
|---|---|---|---|
arr |
原始数组 |
Array（String/Number） |
是 |
start |
起始位置 |
Integer |
是 |
end |
结束位置 |
Integer |
是 |
返回值类型：Array类型
示例：SELECT MV_SLICE(ARRAY('1','2','3','4','5'), 2, 4)
类型 |
场景 |
|---|---|
查询语句 |
MV_SLICE(ARRAY('1','2','3','4','5'), 2, 4) |
返回结果 |
["3","4"] |
mv_to_string函数
通过str指定分隔符连接arr所有元素。
语法：mv_to_string(arr, str)
参数名称 |
描述 |
类型 |
是否必选 |
|---|---|---|---|
arr |
原始数组 |
Array（String/Number） |
是 |
str |
指定字符 |
String |
是 |
返回值类型：String类型
示例：SELECT MV_TO_STRING(ARRAY('1','2','3','4','5'),'-')
类型 |
场景 |
|---|---|
查询语句 |
MV_TO_STRING(ARRAY('1','2','3','4','5'),'-') |
返回结果 |
1-2-3-4-5 |
string_to_mv函数
使用指定的分隔符str2将str1拆分为数组。
语法：string_to_mv(str1, str2)
参数名称 |
描述 |
类型 |
是否必选 |
|---|---|---|---|
str1 |
原始字符串 |
String |
是 |
str2 |
指定字符 |
String |
是 |
返回值类型：Array类型
示例：SELECT STRING_TO_MV('1-2-3-4-5','-')
类型 |
场景 |
|---|---|
查询语句 |
STRING_TO_MV ('1-2-3-4-5','-') |
返回结果 |
["1","2","3","4","5"] |
mv_offset函数
返回所提供的基于0的索引处的数组元素，或对于超出范围的索引返回null。
语法：mv_offset(arr, index)
参数名称 |
描述 |
类型 |
是否必选 |
|---|---|---|---|
arr |
原始数组 |
Array（String/Number） |
是 |
index |
指定索引位置 |
Integer |
是 |
返回值类型：String/Integer/Long/Boolean/Double类型
示例：SELECT MV_OFFSET(ARRAY('1','2','3','4','5'), 2)
类型 |
场景 |
|---|---|
查询语句 |
MV_OFFSET(ARRAY('1','2','3','4','5'), 2) |
返回结果 |
3 |
mv_ordinal函数
返回所提供的基于1的索引处的数组元素，或对于超出范围的索引返回null。
语法：mv_ordinal(arr, index)
参数名称 |
描述 |
类型 |
是否必选 |
|---|---|---|---|
arr |
原始数组 |
Array（String/Number） |
是 |
index |
指定索引位置 |
Integer |
是 |
返回值类型：String/Integer/Long/Boolean/Double类型
示例：SELECT MV_ORDINAL(ARRAY('1','2','3','4','5'), 2)
类型 |
场景 |
|---|---|
查询语句 |
MV_ORDINAL (ARRAY('1','2','3','4','5'), 2) |
返回结果 |
2 |
mv_offset_of函数
返回数组中第一次出现expr的基于0的索引，如果未出现，则返回-1。
语法：mv_offset_of(arr, expr)
参数名称 |
描述 |
类型 |
是否必选 |
|---|---|---|---|
arr |
原始数组 |
Array（String/Number） |
是 |
expr |
指定元素 |
String/Number |
是 |
返回值类型：Integer类型
示例：SELECT MV_OFFSET_OF(ARRAY('1','2','3','4','5'), '2')
类型 |
场景 |
|---|---|
查询语句 |
MV_OFFSET_OF(ARRAY('1','2','3','4','5'), '2') |
返回结果 |
1 |
mv_ordinal_of函数
返回数组中第一次出现expr的基于1的索引，如果未出现，则返回-1。
语法：mv_ordinal_of(arr, expr)
参数名称 |
描述 |
类型 |
是否必选 |
|---|---|---|---|
arr |
原始数组 |
Array（String/Number） |
是 |
expr |
指定元素 |
String/Number |
是 |
返回值类型：Integer类型
示例：SELECT MV_ORDINAL_OF(ARRAY('1','2','3','4','5'), '2')
类型 |
场景 |
|---|---|
查询语句 |
MV_ORDINAL_OF (ARRAY('1','2','3','4','5'), '2') |
返回结果 |
2 |
FAQ
FAQ（常见问题）展示经常被询问的问题。
