文档中心

日志服务

SQL 函数

数学计算函数

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

函数列表

说明

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

函数名称	函数语法	说明
ABS 函数	ABS(KEY)	计算目标值的绝对值。
ACOS 函数	ACOS(KEY)	计算值的反余弦。
ASIN 函数	ASIN(KEY)	计算值的反正弦。
ATAN 函数	ATAN(KEY)	计算值的反正切。
CBRT 函数	CBRT(KEY)	计算值的立方根。
CEIL 函数	CEIL(KEY)	对值进行向上取整数。
CEILING 函数	CEILING(KEY)	对值进行向上取整数。
COS 函数	COS(KEY)	计算值的余弦。
COSH 函数	COSH(KEY)	计算值的双曲余弦。
COSINE_SIMILARITY 函数	COSINE_SIMILARITY(KEY1, KEY2)	计算两个值之间的余弦相似度。
DEGREES 函数	DEGREES(KEY)	将弧度转换为度。
E 函数	E()	计算自然底数 e 的值。
EXP 函数	EXP(x)	计算自然底数 e 的 x 次幂。
FLOOR 函数	FLOOR(KEY)	对目标值进行向下取整数。
FROM_BASE 函数	FROM_BASE(number_str, base)	将一个给定进制的数字字符串转换为十进制。
IS_NAN 函数	IS_NAN(KEY)	判断值是否为 NaN。
LN 函数	LN(KEY)	计算值的自然对数。
LOG 函数	LOG(KEY)	计算目标值的自然对数。
LOG2 函数	LOG2(KEY)	计算目标值以 2 为底的对数。
LOG10 函数	LOG10(KEY)	计算目标值以 10 为底的对数。
MOD 函数	MOD(KEY1, KEY2)	计算两个值相除的余数。
NAN 函数	NAN()	获取 NaN 值。
PI 函数	PI()	返回 π 值，精确到小数点后 15 位。
POWER函数	POWER(KEY, y)	计算目标值的 y 次幂。
RADIANS 函数	RADIANS(KEY)	将度转换为弧度。
RAND 函数	RAND()	返回一个随机数。
RANDOM 函数	RANDOM()	返回 [0,1) 之间的随机数。
RANDOM 函数		RANDOM(KEY)	返回 [0,KEY) 之间的随机数。
ROUND 函数	ROUND(KEY)	对目标值进行四舍五入取整数。
ROUND 函数		ROUND(KEY,n)	对目标值进行四舍五入，并保留 n 位小数。
SIGN 函数	SIGN(KEY)	确定目标值的符号，通过1、0、-1表示该数值的正负性。
SIN 函数	SIN(KEY)	计算目标值的正弦。
SQRT 函数	SQRT(KEY)	计算目标值的平方根。
TAN 函数	TAN(KEY)	计算目标值的正切。
TANH 函数	TANH(KEY)	计算目标值的双曲正切。
TO_BASE 函数	TO_BASE(number, base)	将一个十进制转换为指定进制的字符串。
WIDTH_BUCKET 函数	WIDTH_BUCKET(KEY, bound1, bound2, numBuckets)	将一段数值范围划分成大小相同的多个 Bucket，然后返回 KEY 值所在 Bucket 的编号。
WIDTH_BUCKET 函数		WIDTH_BUCKET(KEY, bins)	使用数组指定 Bucket 的范围，然后返回 KEY 值所在 Bucket 的编号。

ABS 函数

ABS 函数用于计算目标值的绝对值。

函数语法

语法格式

ABS(KEY)

参数说明

参数
说明
KEY
字段、表达式，其值为 Smallint、Integer、Real、Tinyint、Bigint、Double、Decimal类型。

返回值说明

返回值与参数值的类型一致。

函数示例

场景

计算 RespSize 字段值的绝对值。

日志样例

检索和分析语句

* | SELECT abs(RespSize)

检索和分析结果

ACOS 函数

ACOS 函数用于计算值的反余弦。

函数语法

语法格式

ACOS(KEY)

参数说明

参数
说明
KEY
字段、表达式，其值为 Double 类型，取值范围为 [-1,1]，如果超出 [-1,1]，则返回 NaN。

返回值说明

返回值为 Double 类型。

函数示例

场景

计算 45° 角的反余弦。

检索和分析语句

* | SELECT ACOS(PI()/4)

检索和分析结果

ASIN 函数

ASIN 函数用于计算值的反正弦。

函数语法

语法格式

ASIN(KEY)

参数说明

参数
说明
KEY
字段、表达式，其值为 Double类型，取值范围为 [-1,1]，如果超出 [-1,1]，则返回 NaN。

返回值说明

返回值为 Double 类型。

函数示例

场景

计算 45° 角的反正弦。

检索和分析语句

* | SELECT ASIN(PI()/4)

检索和分析结果

ATAN 函数

ATAN 函数用于计算值的反正切。

函数语法

语法格式

ATAN(KEY)

参数说明

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

返回值说明

返回值为 Double 类型。

函数示例

场景

计算45°角的反正切。

检索和分析语句

* | SELECT ATAN(PI()/4)

检索和分析结果

CBRT 函数

CBRT 函数用于计算值的立方根。

函数语法

语法格式

CBRT(KEY)

参数说明

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

返回值说明

返回值为 Double 类型。

函数示例

场景

计算 64 的立方根。

检索和分析语句

* | SELECT CBRT(64)

检索和分析结果

CEIL 函数

CEIL 函数用于对值进行向上取整数。CEIL 函数与 CEILING 函数相同。

函数语法

语法格式

CEIL(KEY)

参数说明

参数	说明
KEY	字段、表达式，其值为 tinyint、smallint、integer、real、bigint、double、decimal 类型。 KEY 值为正数，则朝远离 0 的方向取整。 KEY 值为负数，则朝向 0 的方向取整。

返回值说明

返回值与参数值的类型一致。

函数示例

场景

对 ReqTime 字段的值进行向上取整数。

字段样例

ReqTime:1.7

检索和分析语句

* | SELECT ceil(ReqTime) AS ReqTime

检索和分析结果

CEILING 函数

CEILING 函数用于对值进行向上取整数。

函数语法

语法格式

CEILING(KEY)

参数说明

参数	说明
KEY	字段、表达式，其值为 tinyint、smallint、integer、real、bigint、double、decimal 类型。 KEY 为正数，则朝远离 0 的方向取整。 KEY 为负数，则朝向 0 的方向取整。

返回值说明

返回值与参数值的类型一致。

函数示例

场景

对 ReqTime 字段的值进行向上取整数。

字段样例

ReqTime:1.7

检索和分析语句

* | SELECT CEILING(ReqTime) AS ReqTime

检索和分析结果

COS 函数

COS 函数用于计算值的余弦。

函数语法

语法格式

COS(KEY)

参数说明

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

返回值说明

返回值与 Double 类型。

函数示例

场景

计算 60° 角的余弦。

检索和分析语句

* | SELECT COS(PI()/3)

检索和分析结果

COSH 函数

COSH 函数用于计算值的双曲余弦。

函数语法

语法格式

COSH(KEY)

参数说明

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

返回值说明

返回值与 Double 类型。

函数示例

场景

计算 60° 角的双曲余弦。

检索和分析语句

* | SELECT COSH(PI()/3)

检索和分析结果

COSINE_SIMILARITY 函数

COSINE_SIMILARITY 函数用于计算两个值之间的余弦相似度。

函数语法

语法格式

COSINE_SIMILARITY(KEY1, KEY2)

参数说明

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

返回值说明

返回值为 Double 类型。

函数示例

场景

计算两个向量之间的余弦相似度。

检索和分析语句

* | SELECT COSINE_SIMILARITY(MAP(ARRAY['regan'], ARRAY[2.3]), MAP(ARRAY['regan'], ARRAY[3.7]))

检索和分析结果

DEGREES 函数

DEGREES 函数用于将弧度转换为度。

函数语法

语法格式

DEGREES(KEY)

参数说明

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

返回值说明

返回值为 Double 类型。

函数示例

场景

将弧度 π 转换为度。

检索和分析语句

* | SELECT DEGREES(PI())

检索和分析结果

E 函数

E 函数计算自然底数 e 的值。

函数语法

语法格式

返回值说明

返回值为 Double类型。

函数示例

场景

返回自然底数 e 的值。

检索和分析语句

* | SELECT E()

检索和分析结果

EXP 函数

EXP 函数用于计算自然底数 e 的 x 次幂。

函数语法

语法格式

EXP(x)

参数说明

参数
说明
x
值为 Double 类型。

返回值说明

返回值为 Double 类型。

函数示例

场景

计算自然底数 e 的 4 次幂。

检索和分析语句

* | SELECT EXP(4)

检索和分析结果

FLOOR 函数

FLOOR 函数用于对目标值进行向下取整数。

函数语法

语法格式

FLOOR(KEY)

参数说明

参数
说明
KEY
字段、表达式，其值为 Tinyint、Smallint、Integer、Real、Bigint、Double、Decimal 类型。

返回值说明

返回比参数值小的最大整数。返回值为 Double 类型。

函数示例

场景

计算 ReqSize 字段值的平方根，再进行向下取整数。

日志样例

检索和分析语句

* | SELECT FLOOR(SQRT(ReqSize))

检索和分析结果

FROM_BASE 函数

FROM_BASE 函数用于将一个给定进制的数字字符串转换为十进制。

函数语法

语法格式

FROM_BASE(number_str, base)

参数说明

参数
说明
number_str
数字字符串，Varchar 类型。
base
number_str 的进制，Bigint 类型。取值范围为 [2,36]。

返回值说明

返回值为 Bigint 类型。

函数示例

场景

将字符串 1001100110 转换为十进制数。

检索和分析语句

* | SELECT FROM_BASE('1001100110',2)

检索和分析结果

IS_NAN 函数

IS_NAN 函数用于判断值是否为 NaN。如果是，则返回 true。

函数语法

语法格式

IS_NAN(KEY)

参数说明

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

返回值说明

返回值为 Boolean 类型。

函数示例

场景

判断 apply_time 字段的值是否为 NaN。

检索和分析语句

* | SELECT IS_NAN(apply_time)

检索和分析结果

LN 函数

LN 函数用于计算值的自然对数。

函数语法

语法格式

参数说明

参数
说明
KEY
字段、表达式，值为 Double 类型，取值需大于 0。

返回值说明

返回值为double类型。

函数示例

场景

计算 5 的自然对数。

检索和分析语句

* | SELECT LN(5)

检索和分析结果

LOG 函数

LOG 函数用于目标值的自然对数。

函数语法

语法格式

LOG(KEY)

参数说明

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

返回值说明

返回值为 Double 类型。

函数示例

场景

计算 ReqSize 字段值的自然对数。

日志样例

检索和分析语句

* | SELECT LOG(ReqSize)

检索和分析结果

LOG2 函数

LOG2 函数用于计算目标值以 2 为底的对数。

函数语法

语法格式

LOG2(KEY)

参数说明

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

返回值说明

返回值为 Double 类型。

函数示例

场景

计算 80 以 2 为底的对数。

检索和分析语句

* | SELECT LOG2(80)

检索和分析结果

LOG10 函数

LOG10 函数用于计算目标值以 10 为底的对数。

函数语法

语法格式

LOG10(KEY)

参数说明

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

返回值说明

返回值为 Double 类型。

函数示例

场景

计算 ReqSize 字段值以 10 为底的对数。

日志样例

检索和分析语句

* | SELECT LOG10(ReqSize)

检索和分析结果

MOD 函数

MOD 函数用于计算两个值相除的余数。

函数语法

语法格式

MOD(KEY1, KEY2)

参数说明

参数
说明
KEY
字段、表达式，其值为 tinyint、smallint、integer、real、bigint、double、decimal 类型。

返回值说明

返回值与参数值的数据类型一致。

函数示例

场景

计算 97 与 6 相除的余数。

检索和分析语句

* | SELECT MOD(97,6)

检索和分析结果

NAN 函数

NAN 函数用于获取 NaN 值。

函数语法

语法格式

NAN()

返回值说明

返回值为 Double 类型。

函数示例

场景

返回一个 NaN 值。

检索和分析语句

* | SELECT NAN()

检索和分析结果

PI 函数

PI 函数用于返回 π 值，精确到小数点后 15 位。

函数语法

语法格式

PI()

返回值说明

返回值为 Double 类型。

函数示例

场景

返回 π 值，精确到小数点后 15 位。

检索和分析语句

* | SELECT PI()

检索和分析结果

POWER 函数

POWER 函数计算目标值的 y 次幂。

函数语法

语法格式

POWER(KEY, y)

参数说明

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

返回值说明

返回值为 Double 类型。

函数示例

场景

计算 ReqSize 字段值的 3 次幂。

日志样例

检索和分析语句

* | SELECT POWER(ReqSize, 3)

检索和分析结果

RAND 函数

RAND 函数用于返回随机数。

函数语法

语法格式

RAND()

返回值说明

返回值为 Double 类型。

函数示例

场景

返回一个随机数。

检索和分析语句

* | SELECT RAND()

检索和分析结果

RADIANS 函数

RADIANS 函数用于将度转换为弧度。

函数语法

语法格式

RADIANS(KEY)

参数说明

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

返回值说明

返回值为 Double 类型。

函数示例

场景

计算 90° 对应的弧度。

检索和分析语句

* | SELECT RADIANS(90)

检索和分析结果

RANDOM 函数

RANDOM 函数用于返回 [0,1) 或 [0,KEY) 之间的随机数。

函数语法

语法格式

返回 [0,1) 之间的随机数。

RANDOM()

返回 [0,KEY) 之间的随机数。

RANDOM(KEY)

参数说明

参数
说明
KEY
字段、表达式，参数值为 Tinyint、Smallint、Integer 或 Bigint 类型。

返回值说明

返回值类型与参数值的类型一致。

函数示例

场景

返回 [0,100) 之间的随机数。

检索和分析语句

* | select RANDOM(100)

检索和分析结果

ROUND 函数

ROUND 函数用于对目标值进行四舍五入。

函数语法

语法格式

对目标值进行四舍五入取整数。

ROUND(KEY)

对目标值进行四舍五入，并保留 n 位小数。

ROUND(KEY,n)

参数说明

参数
说明
KEY
字段、表达式，其值为 Tinyint、Smallint、Integer 或 Bigint 类型。
n
数字精度，即小数部分的位数。

返回值说明

返回值与参数值的数据类型一致。

函数示例

示例1

场景

计算 ReqSize 字段值的平方根，再进行四舍五入取整数。

日志样例

检索和分析语句

* | SELECT ROUND(SQRT(ReqSize))

检索和分析结果

示例2

场景

计算今天与昨天的访问量比值，并保留 4 位小数。

日志样例

检索和分析语句

* |SELECT
diff [1] AS today,
diff [2] AS yesterday,
ROUND(diff [3],4)
FROM (
SELECT
COMPARE(PV, 86400) AS diff
FROM
(
SELECT COUNT(*) AS PV
)
)

检索和分析结果

SIGN 函数

SIGN 函数用于确定目标值的符号，通过 1、0、-1 表示该数值的正负性。

函数语法

语法格式

SIGN(KEY)

参数说明

参数	说明
KEY	字段、表达式，其值为 integer、smallint、tinyint、real、 double、bigint或decimal(p,s)类型。 KEY 值为正数，返回 1。 KEY 值为 0，返回 0。 KEY 值为负数，返回 -1。

返回值说明

返回值与参数值的数据类型一致。

函数示例

场景

确认数字 -3 的符号。

检索和分析语句

* | SELECT SIGN(-3)

检索和分析结果

SIN 函数

SIN 函数用于计算目标值的正弦。

函数语法

语法格式

SIN(KEY)

参数说明

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

返回值说明

返回值为 Double 类型。

函数示例

场景

计算 60° 角的正弦。

检索和分析语句

* | SELECT SIN(PI()/3)

检索和分析结果

SQRT 函数

SQRT 函数用于计算目标值的平方根。

函数语法

语法格式

SQRT(KEY)

参数说明

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

返回值说明

返回值为 Double 类型。

函数示例

场景

计算 ReqSize 字段值的平方根。

日志样例

检索和分析语句

* | SELECT SQRT(ReqSize)

检索和分析结果

TAN 函数

TAN 函数用于计算目标值的正切。

函数语法

语法格式

TAN(KEY)

参数说明

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

返回值说明

返回值为 Double 类型。

函数示例

场景

计算 tan60° 角的正切。

检索和分析语句

* | SELECT TAN(PI()/3)

检索和分析结果

TANH 函数

TANH 函数用于计算目标值的双曲正切。

函数语法

语法格式

TANH(KEY)

参数说明

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

返回值说明

返回值为 Double 类型。

函数示例

场景

计算 60° 的双曲正切。

检索和分析语句

* | SELECT TANH(PI()/3)

检索和分析结果

TO_BASE 函数

TO_BASE 函数将一个十进制转换为指定进制的字符串。

函数语法

语法格式

TO_BASE(number, base)

参数说明

参数
说明
number
值为 Bigint 类型。
base
指定进制，Bigint 类型。取值范围为 [2,36]。

返回值说明

返回值为 Varchar 类型。

函数示例

场景

将 116 转换为二进制字符串。

检索和分析语句

* | SELECT TO_BASE(116, 2)

检索和分析结果

WIDTH_BUCKET 函数

WIDTH_BUCKET 函数用于返回目标值所在 Bucket 的编号。

函数语法

语法格式

将一段数值范围划分成大小相同的多个 Bucket，然后返回 KEY 值所在 Bucket 的编号。

WIDTH_BUCKET(KEY, bound1, bound2, numBuckets)

使用数组指定 Bucket 的范围，然后返回 KEY 值所在 Bucket 的编号。

WIDTH_BUCKET(KEY, bins)

参数说明

参数	说明
KEY	字段，表达式，值为 Double 类型。
bound1	指定数值范围的下限。
bound2	指定数值范围的上限。
numBuckets	Bucket 数量，大于 0 的整数。
bins	使用数组指定 Bucket 的范围。值为 Double 类型的数组。

返回值说明

返回值为 Bigint 类型。

KEY 值在指定范围内时，返回值为 KEY 值所在 Bucket 的编号。

KEY 值下限范围外，返回值为 0。

KEY 值上限范围外，返回值为 numBuckets+1。

函数示例

场景1

示例

将 [0,50) 范围等分为 5 个Bucket，然后返回各个 ReqTime 字段值所在 Bucket 的编号。

检索和分析语句

* | SELECT ReqTime, WIDTH_BUCKET(ReqTime, 0, 50, 5) AS num

检索和分析结果

场景2

示例

使用数组指定 5 个 Bucket 范围，然后返回各个 ReqTime 字段值所在 Bucket 的编号。

检索和分析语句

* | SELECT ReqTime, WIDTH_BUCKET(ReqTime, array[10,20,30,40,50]) AS num

检索和分析结果

最近更新时间：2026.10.19 17:52:08

这个页面对您有帮助吗？

有用

无用

参数	说明
KEY	字段、表达式，其值为 Smallint、Integer、Real、Tinyint、Bigint、Double、Decimal类型。

参数	说明
KEY	字段、表达式，其值为 Double 类型，取值范围为 [-1,1]，如果超出 [-1,1]，则返回 NaN。

参数	说明
KEY	字段、表达式，其值为 Double类型，取值范围为 [-1,1]，如果超出 [-1,1]，则返回 NaN。

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

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

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

参数	说明
number_str	数字字符串，Varchar 类型。
base	number_str 的进制，Bigint 类型。取值范围为 [2,36]。

参数	说明
KEY	字段、表达式，值为 Double 类型，取值需大于 0。

参数	说明
KEY	字段、表达式，参数值为 Tinyint、Smallint、Integer 或 Bigint 类型。

参数	说明
KEY	字段、表达式，其值为 Tinyint、Smallint、Integer 或 Bigint 类型。
n	数字精度，即小数部分的位数。

参数	说明
number	值为 Bigint 类型。
base	指定进制，Bigint 类型。取值范围为 [2,36]。