SQL数学函数

InfluxDB SQL实现支持以下数学函数以执行数学运算

• abs
• acos
• acosh
• asin
• asinh
• atan
• atanh
• atan2
• cbrt
• ceil
• cos
• cosh
• 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

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

参数

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

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

将数字截断到0（小数点）。

trunc(numeric_expression)

参数

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

SELECT trunc(temp) AS trunc FROM home LIMIT 3