SQL 数学函数

InfluxDB 3 Core SQL 实现支持以下用于执行数学运算的函数：

• abs
• acos
• acosh
• asin
• asinh
• atan
• atanh
• atan2
• cbrt
• ceil
• cos
• cosh
• cot
• degrees
• exp
• factorial
• floor
• gcd
• isnan
• iszero
• lcm
• ln
• log
• log10
• log2
• nanvl
• pi
• power
• pow
• radians
• random
• round
• signum
• sin
• sinh
• sqrt
• tan
• tanh
• trunc

abs

返回数字的绝对值。

abs(numeric_expression)

参数

• numeric_expression：要操作的数字表达式。可以是常量、列或函数，以及算术运算符的任意组合。

SELECT abs(temp) AS abs FROM home LIMIT 3

acos

返回数字的反正切或反余弦值。

acos(numeric_expression)

参数

• numeric_expression：要操作的数字表达式。可以是常量、列或函数，以及算术运算符的任意组合。

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

acosh

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

acosh(numeric_expression)

参数

• numeric_expression：要操作的数字表达式。可以是常量、列或函数，以及算术运算符的任意组合。

SELECT acosh(temp) AS acosh FROM home LIMIT 3

asin

返回数字的反正弦或反三角函数值。

asin(numeric_expression)

参数

• numeric_expression：要操作的数字表达式。可以是常量、列或函数，以及算术运算符的任意组合。

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

asinh

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

asinh(numeric_expression)

参数

• numeric_expression：要操作的数字表达式。可以是常量、列或函数，以及算术运算符的任意组合。

SELECT asinh(temp) AS asinh FROM home LIMIT 3

atan

返回数字的反正切或反三角函数值。

atan(numeric_expression)

参数

• numeric_expression：要操作的数字表达式。可以是常量、列或函数，以及算术运算符的任意组合。

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

atanh

返回数字的反双曲正切或面积反双曲正切值。

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

返回数字的立方根。

cbrt(numeric_expression)

参数

• numeric_expression：要操作的数字表达式。可以是常量、列或函数，以及算术运算符的任意组合。

SELECT cbrt(temp) AS cbrt FROM home LIMIT 3

ceil

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

ceil(numeric_expression)

参数

• numeric_expression：要操作的数字表达式。可以是常量、列或函数，以及算术运算符的任意组合。

SELECT ceil(temp) AS ceil FROM home LIMIT 3

cos

返回数字的余弦值。

cos(numeric_expression)

参数

• numeric_expression：要操作的数字表达式。可以是常量、列或函数，以及算术运算符的任意组合。

SELECT cos(temp) AS cos FROM home LIMIT 3

cosh

返回数字的双曲余弦值。

cosh(numeric_expression)

参数

• numeric_expression：要操作的数字表达式。可以是常量、列或函数，以及算术运算符的任意组合。

SELECT cosh(temp) AS cosh FROM home LIMIT 3

cot

返回数字的余切值。

cot(numeric_expression)

参数

• numeric_expression：要操作的数字表达式。可以是常量、列或函数，以及算术运算符的任意组合。

SELECT cot(a) AS cot FROM numbers LIMIT 3

degrees

将弧度转换为度。

degrees(numeric_expression)

参数

• numeric_expression：要操作的数字表达式。可以是常量、列或函数，以及算术运算符的任意组合。

SELECT degrees(a) AS degrees FROM numbers LIMIT 3

exp

返回数字的以 e 为底的指数值。

exp(numeric_expression)

参数

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

SELECT exp(temp) AS exp FROM home LIMIT 3

factorial

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

factorial(numeric_expression)

参数

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

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

floor

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

floor(numeric_expression)

参数

• numeric_expression：要操作的数字表达式。可以是常量、列或函数，以及算术运算符的任意组合。

SELECT floor(temp) AS floor FROM home LIMIT 3

gcd

返回 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

isnan

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

isnan(numeric_expression)

参数

• numeric_expression：要操作的数字表达式。必须是浮点数（DOUBLE）。可以是常量、列或函数，以及算术运算符的任意组合。

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

iszero

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

iszero(numeric_expression)

参数

• numeric_expression：要操作的数字表达式。可以是常量、列或函数，以及算术运算符的任意组合。

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

lcm

返回 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

返回数字的自然对数。

ln(numeric_expression)

参数

• numeric_expression：要操作的数字表达式。可以是常量、列或函数，以及算术运算符的任意组合。

SELECT ln(temp) AS ln FROM home LIMIT 3

log

返回数字的以 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

log10

返回数字的以 10 为底的对数。

log10(numeric_expression)

参数

• numeric_expression：要操作的数字表达式。可以是常量、列或函数，以及算术运算符的任意组合。

SELECT log10(temp) AS log10 FROM home LIMIT 3

log2

返回数字的以 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

返回 π 的近似值。

pi()

SELECT pi() AS pi

power

将基数表达式求幂到指数。

power(base, exponent)

别名

• pow

参数

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

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

pow

power 函数的别名。

radians

将度转换为弧度。

radians(numeric_expression)

参数

• numeric_expression：要操作的数字表达式。可以是常量、列或函数，以及算术运算符的任意组合。

SELECT radians(b) AS radians FROM numbers LIMIT 3

random

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

random()

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

round

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

round(numeric_expression)

参数

• numeric_expression：要操作的数字表达式。可以是常量、列或函数，以及算术运算符的任意组合。

SELECT round(temp) AS round FROM home LIMIT 3

signum

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

signum(numeric_expression)

参数

• numeric_expression：要操作的数字表达式。可以是常量、列或函数，以及算术运算符的任意组合。

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

sin

返回数字的正弦值。

sin(numeric_expression)

参数

• numeric_expression：要操作的数字表达式。可以是常量、列或函数，以及算术运算符的任意组合。

SELECT sin(temp) AS sin FROM home LIMIT 3

sinh

返回数字的双曲正弦值。

sinh(numeric_expression)

参数

• numeric_expression：要操作的数字表达式。可以是常量、列或函数，以及算术运算符的任意组合。

SELECT sinh(temp) AS sinh FROM home LIMIT 3

sqrt

返回数字的平方根。

sqrt(numeric_expression)

参数

• numeric_expression：要操作的数字表达式。可以是常量、列或函数，以及算术运算符的任意组合。

SELECT sqrt(temp) AS sqrt FROM home LIMIT 3

tan

返回数字的正切值。

tan(numeric_expression)

参数

• numeric_expression：要操作的数字表达式。可以是常量、列或函数，以及算术运算符的任意组合。

SELECT tan(temp) AS tan FROM home LIMIT 3

tanh

返回数字的双曲正切值。

tanh(numeric_expression)

参数

• numeric_expression：要操作的数字表达式。可以是常量、列或函数，以及算术运算符的任意组合。

SELECT tanh(a) AS tanh FROM numbers LIMIT 3

trunc

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

trunc(numeric_expression)

参数

• numeric_expression：要操作的数字表达式。可以是常量、列或函数，以及算术运算符的任意组合。

SELECT trunc(temp) AS trunc FROM home LIMIT 3