SQL 数学函数

InfluxDB 集群 SQL 实现支持以下数学函数以进行数学运算：

• abs
• 反余弦
• 反双曲余弦函数
• 反正弦
• 反双曲正弦
• atan
• 反双曲正切
• atan2
• cbrt
• ceil
• cos
• cosh
• 度数
• exp
• 阶乘
• 向下取整
• 最大公约数
• isnan
• iszero
• lcm
• ln
• 对数
• log10
• log2
• nanvl
• pi
• 功率
• pow
• 弧度
• 随机
• 四舍五入
• 符号
• sin
• sinh
• sqrt
• 反正切
• tanh
• trunc

绝对值

返回一个数字的绝对值。

abs(numeric_expression)

参数

• numeric_expression: 用于操作的数值表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT abs(temp) AS abs FROM home LIMIT 3

反余弦

返回一个数字的反余弦或反余弦值。

acos(numeric_expression)

参数

• numeric_expression: 用于操作的数值表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT acos(temp * .01) AS acos FROM home LIMIT 3

反双曲余弦函数

返回一个数字的双曲余弦或反双曲余弦的面积。

acosh(numeric_expression)

参数

• numeric_expression: 用于操作的数值表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT acosh(temp) AS acosh FROM home LIMIT 3

反正弦

返回一个数字的反正弦或反正弦值。

asin(numeric_expression)

参数

• numeric_expression: 用于操作的数值表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT asin(temp * .01) AS asin FROM home LIMIT 3

反双曲正弦函数

返回一个数字的双曲正弦或双曲反正弦的面积。

asinh(numeric_expression)

参数

• numeric_expression: 用于操作的数值表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT asinh(temp) AS asinh FROM home LIMIT 3

反正切

返回一个数字的反正切或反正切值。

atan(numeric_expression)

参数

• numeric_expression: 用于操作的数值表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT atan(temp * .01) AS atan FROM home LIMIT 3

反双曲正切

返回一个数的双曲正切或反双曲正切的面积。

atanh(numeric_expression)

参数

• numeric_expression: 用于操作的数值表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT atanh(temp * .01) AS atanh FROM home LIMIT 3

反正切函数 atan2

返回expression_y / expression_x的反正切或弧正切。

atan2(expression_y, expression_x)

参数

• expression_y: 第一个要操作的数字表达式。可以是常量、列或函数，以及任何算术运算符的组合。
• expression_x: 第二个要操作的数字表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT atan2(temp, hum) AS atan2 FROM home LIMIT 3

立方根

返回一个数字的立方根。

cbrt(numeric_expression)

参数

• numeric_expression: 用于操作的数值表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT cbrt(temp) AS cbrt FROM home LIMIT 3

向上取整

返回大于或等于一个数的最小整数。

ceil(numeric_expression)

参数

• numeric_expression: 用于操作的数值表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT ceil(temp) AS ceil FROM home LIMIT 3

余弦

返回一个数字的余弦值。

cos(numeric_expression)

参数

• numeric_expression: 用于操作的数值表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT cos(temp) AS cos FROM home LIMIT 3

双曲余弦

返回一个数的双曲余弦值。

cosh(numeric_expression)

参数

• numeric_expression: 用于操作的数值表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT cosh(temp) AS cosh FROM home LIMIT 3

度数

将弧度转换为角度。

degrees(numeric_expression)

参数

• numeric_expression: 用于操作的数值表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT degrees(a) AS degrees FROM numbers LIMIT 3

指数

返回一个数的以e为底的指数。

exp(numeric_expression)

参数

• numeric_expression: 用作指数的数字表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT exp(temp) AS exp FROM home LIMIT 3

阶乘

如果值小于2，则返回1。

factorial(numeric_expression)

参数

• numeric_expression: 要操作的数字表达式。 必须是整数（BIGINT）。 可以是常量、列或函数，以及任何算术运算符的组合。

SELECT factorial((b + 2)::BIGINT) AS factorial FROM numbers LIMIT 3

向下取整

返回小于或等于一个数字的最接近的整数。

floor(numeric_expression)

参数

• numeric_expression: 用于操作的数值表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT floor(temp) AS floor FROM home LIMIT 3

最大公约数

返回 expression_x 和 expression_y 的最大公约数。
如果两个输入都为零，则返回 0。

gcd(expression_x, expression_y)

参数

• expression_x: 第一个要操作的数字表达式。 必须是一个整数 (BIGINT)。 可以是常量、列或函数，以及任何算术运算符的组合。
• expression_y: 第二个操作的数字表达式。必须是一个整数 (BIGINT)。可以是常量、列或函数，以及任何组合的算术运算符。

SELECT gcd((a * 5)::BIGINT, (b * 5)::BIGINT) AS gcd FROM numbers LIMIT 3

是否为NaN

如果给定的数字是±NaN，则返回 true，否则返回 false。

isnan(numeric_expression)

参数

• numeric_expression: 数值表达式进行操作。 必须是一个浮点数 (DOUBLE)。 可以是常数、列或函数，以及任何算术运算符的组合。

SELECT isnan(a)
FROM
  (VALUES (4.56),
          ('NaN'::DOUBLE),
          (16.2)
  ) AS data(a)

是否为零

如果给定的数字是±0.0，则返回 true，否则返回 false。

iszero(numeric_expression)

参数

• numeric_expression: 用于操作的数值表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT iszero(a)
FROM
  (VALUES (0),
          (1),
          (2)
  ) AS data(a)

最小公倍数

返回expression_x和expression_y的最小公倍数。如果任一输入为零，则返回0。

lcm(expression_x, expression_y)

参数

• expression_x: 第一个要操作的数字表达式。 必须是一个整数 (BIGINT)。 可以是常量、列或函数，以及任何算术运算符的组合。
• expression_y: 第二个操作的数字表达式。必须是一个整数 (BIGINT)。可以是常量、列或函数，以及任何组合的算术运算符。

SELECT lcm((a * 10)::BIGINT, (b * 10)::BIGINT) AS lcm FROM numbers LIMIT 3

自然对数

返回一个数的自然对数。

ln(numeric_expression)

参数

• numeric_expression: 用于操作的数值表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT ln(temp) AS ln FROM home LIMIT 3

日志

返回一个数字的基数-x 对数。

log([base, ]numeric_expression)

参数

• base: 操作的基础数字表达式。 可以是常量、列或函数，以及任何算术运算符的组合。 默认值是 10。
• numeric_expression: 用于操作的数值表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT
  temp,
  log(2, temp) AS temp_log2,
  log(4, temp) AS temp_log4,
  log(temp) AS temp_log10
FROM home
LIMIT 3

以10为底的对数

返回一个数的以10为底的对数。

log10(numeric_expression)

参数

• numeric_expression: 用于操作的数值表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT log10(temp) AS log10 FROM home LIMIT 3

对数以2为底

返回一个数字的以2为底的对数。

log2(numeric_expression)

参数

• numeric_expression: 用于操作的数值表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT log2(temp) AS log2 FROM home LIMIT 3

nanvl

如果第一个参数不是 ±NaN，则返回第一个参数。否则返回第二个参数。

nanvl(expression_x, expression_y)

参数

• expression_x: 如果不是 NaN 则返回的数值表达式。 可以是常量、列或函数，以及任何算术运算符的组合。
• expression_y: 如果第一个表达式为 NaN，则返回的数值表达式。可以是常量、列或函数，以及算术运算符的任意组合。

SELECT nanvl(a, 0.0) AS nanvl
FROM
  (VALUES (4.56),
          ('NaN'::DOUBLE),
          (16.2)
  ) AS data(a)

圆周率

返回π的近似值。

pi()

SELECT pi() AS pi

功率

返回一个基本表达式的指数幂。

power(base, exponent)

别名

• pow

参数

• base: 数值表达式进行操作。 可以是常量、列或函数，以及任何算术运算符的组合。
• exponent: 指要操作的指数数值表达式。可以是常量、列或函数，以及任意组合的算术运算符。

SELECT power(temp, hum * .1) AS power FROM home LIMIT 3

pow

的别名 power。

弧度

将度转换为弧度。

radians(numeric_expression)

参数

• numeric_expression: 用于操作的数值表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT radians(b) AS radians FROM numbers LIMIT 3

随机数

返回一个介于0和1之间的随机浮点值。 随机种子对于每一行都是唯一的。

random()

SELECT temp * random() AS random FROM home LIMIT 3

四舍五入

将一个数字四舍五入到最接近的整数。

round(numeric_expression)

参数

• numeric_expression: 用于操作的数值表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT round(temp) AS round FROM home LIMIT 3

符号函数

返回一个数字的符号。 负数返回 -1。 零和正数返回 1。

signum(numeric_expression)

参数

• numeric_expression: 用于操作的数值表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT signum(temp - 23) AS signum FROM home LIMIT 3

正弦

返回一个数字的正弦值。

sin(numeric_expression)

参数

• numeric_expression: 用于操作的数值表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT sin(temp) AS sin FROM home LIMIT 3

双曲正弦函数

返回一个数字的双曲正弦。

sinh(numeric_expression)

参数

• numeric_expression: 用于操作的数值表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT sinh(temp) AS sinh FROM home LIMIT 3

平方根

返回一个数的平方根。

sqrt(numeric_expression)

参数

• numeric_expression: 用于操作的数值表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT sqrt(temp) AS sqrt FROM home LIMIT 3

正切

返回一个数的正切值。

tan(numeric_expression)

参数

• numeric_expression: 用于操作的数值表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT tan(temp) AS tan FROM home LIMIT 3

双曲正切

返回一个数的双曲正切。

tanh(numeric_expression)

参数

• numeric_expression: 用于操作的数值表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT tanh(a) AS tanh FROM numbers LIMIT 3

截断

将数字截断为零（在小数点处）。

trunc(numeric_expression)

参数

• numeric_expression: 用于操作的数值表达式。可以是常量、列或函数，以及任何算术运算符的组合。

SELECT trunc(temp) AS trunc FROM home LIMIT 3