函数列表

更新时间：2024-10-15 GMT+08:00

ResourceQL支持以下函数：

表1 数学运算函数
函数	功能描述
abs(x)	返回x的绝对值。
ceil/ceiling(x)	把小数x向上取整。
floor(x)	把小数x向下取整。
pow/power(x, p) → double	计算x^p。
round(x)	把小数x四舍五入取整。
round(x, d)	把小数x四舍五入保留d位小数。
sign(x)	返回x的符号，正数是1负数是-1。

表2 字符串函数
函数	功能描述
concat(str1, str2, ..., strn) → string	合并字符串。
chr(n) → string	把数字n转化成对应的unicode字符。
codepoint(str) → int	把unicode字符转化成数字。
length(str) → int	返回字符串的长度。
lower/upper(str) → string	把字符串变换成全小写/大写。
replace(str, sub) → string	把字符串str里所有sub子串都删除。
replace(str, sub, replace) → string	把字符串str里所有sub子串都替换成replace。
reverse(str) → string	把字符串str翻转。
split(str, delimiter) → array	把字符串str按照delimiter切割成数组。
strpos(str, sub) → int	返回str里第一次出现sub的下标。下标从1开始，不存在返回0。
strpos(str, sub, n) -> int	返回str里第n次出现sub的下标。下标从1开始，不存在返回0。
strrpos(str, sub) → int	返回str里倒数第一次出现sub的下标。下标从1开始，不存在返回0。
strrpos(str, sub, n) -> int	返回str里倒数第n次出现sub的下标。下标从1开始，不存在返回0 。
substr(str, start) → string	返回str里从start开始的子串。
substr(str, start, length) → string	返回str里从start开始，长度为length的子串。
trim/lstrim/rstrim(str)	把str里开头和结尾/开头/结尾的空白字符删掉。

表3 数组函数
函数	功能描述
all_match(array(T), function(T, boolean)) → boolean	询问每个函数是否都满足给定函数。
any_match(array(T), function(T, boolean)) → boolean	询问是否存在元素满足给定函数。
array_average(a) → double	返回数组a的平均值。
array_distinct(a) → array	返回数组a去重后的新数组。
array_frequency(a) → map	统计数组中每个元素出现的次数并返回对应的map。
array_has_duplicates(a) → boolean	查询数组中是否有重复元素。
array_intersect(a, b) → array	对数组a和b的元素求个交集。
array_join(x, delimiter) → string	把数组元素连接成字符串，中间用delimiter来分隔。
array_join(x, delimiter[, null_replacement]) → string	把数组元素连接成字符串，中间用delimiter来分隔，null元素用null_replacement填充。
array_max/array_min(a)	返回数组a的最大值/最小值。
array_position(a, element) → int	查询element在数组a中的位置。如果不存在返回0。
array_position(a, element, instance) → int	查询element在数组a中的位置。如果不存在返回0。如果'instance>0'，返回第'instance' 出现的位置；如果'instance < 0'，返回倒数'instance'位置。
array_remove(a, element) → array	把数组a中等于element的元素都删除。
array_sort(a) → array	返回数组a排序后的新数组。
array_sort(array(T), function(<T, T>, int)) → array	返回数组a排序后的新数组。需要提供一个二元比较函数，(-1,0,1) 分别表示小于等于和大于。
array_sum(a)	返回数组a的元素和。
array_union(a, b) → array	返回a和b的并集的数组。
array_except(x, y) → array	返回x中但不在y中的元素数组。
cardinality(a) → int	返回数组a的大小。
concat(a1, a2, ...) → array	合并数组，等价于'\|\|'运算符。
contains(a, element) → boolean	判断element是否出现在数组a中。
element_at(a, index)	返回数组a中的第index个元素。如果'index < 0'将从后往前找。
filter(array(T), function(T, boolean)) → array(T)	筛选满足条件的元素组成新数组。
none_match(array(T), function(T, boolean)) → boolean	询问是否所有元素都不满足给定函数。
reverse(a) → array	把数组a前后取反。
sequence(start, stop, step)	和python的range效果类似。
shuffle(a) → array	把数组a的元素打乱。
slice(a, start, length) → array	截取数组a从start开始长度为length的子串。
transform(array(T), function(T, S)) → array(S)	把原数组变换成另一个数组。

表4 聚合函数
函数	功能描述
arbitrary(x)	返回任意一个非NULL的元素（如果存在的话）。
array_agg(x) → array	把元素合并成一个数组返回。
avg(x)→ double	返回算术平均数。
bool_and/bool_or(x) → boolean	对每个元素执行布尔AND/OR。
coalesce(value1, value2, ...)	返回第一个非NULL的元素。会被短路。
count(*)/count(x) → int	计数。
greatest(value1, value2, ..., valueN)	返回给定同类型权值里最大的权值。
histogram(x) → map	返回一个map，统计了x里每个不同的权值以及他们对应的个数。
least(value1, value2, ..., valueN)	返回给定同类型权值里最小的权值。
max/min(x, n=1)	返回元素里的最大/小值，第n大/小值。
max_by/min_by(x, y, n=1)	根据元素y的最大/小值或第n大/小值，返回对应的元素x。
geometric_mean(x) → double	返回几何平均数。
set_agg(x) → array	把元素去重后合并成一个数组返回。
set_union(x) → array	把每个读入的数组的元素求并，返回并集的数组。
sum(x)	返回和。
multimap_agg(key, value)	返回从输入键/值对创建的多重映射。
map_agg(key, value)	返回从输入键/值对创建的映射。

表5 时间函数
函数	功能描述
now() → date	获取当前时间。
date_diff(unit, timestamp1, timestamp2) → int	返回timestamp2-timestamp1在unit下的时间间隔，unit的可选值：millisecond、second、minute、hour、day、week、month、quarter、year。
date_parse(string, format) → timestamp	通过指定格式format，将字符串转为时间格式。

父主题： ResourceQL语法

上一篇：语法文档

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问

函数列表

相关文档

意见反馈

文档内容是否对您有帮助？

7*24

备案

专业服务

退订

建议反馈

售前咨询热线

文档反馈