« 全文搜索函数 字符串函数 »
Elastic 文档 ›Elasticsearch 指南 [8.16] ›SQL ›函数和运算符

数学函数

编辑

数学函数

编辑

所有数学和三角函数都需要其输入（在适用情况下）为数字。

通用函数

编辑

ABS

编辑

语法

ABS(numeric_exp)

输入:

数值表达式。如果为null，则函数返回null。

输出: 数值

描述: 返回numeric_exp的绝对值。返回类型与输入类型相同。

SELECT ABS(-123.5), ABS(55);

  ABS(-123.5)  |    ABS(55)
---------------+---------------
123.5          |55

CBRT

编辑

语法

CBRT(numeric_exp)

输入:

数值表达式。如果为null，则函数返回null。

输出: 双精度数值

描述: 返回numeric_exp的立方根。

SELECT CBRT(-125.5);

   CBRT(-125.5)
-------------------
-5.0066577974783435

CEIL/CEILING

编辑

语法

CEIL(numeric_exp)

输入:

数值表达式。如果为null，则函数返回null。

输出: 整数或长整型数值

描述: 返回大于或等于numeric_exp的最小整数。

SELECT CEIL(125.01), CEILING(-125.99);

 CEIL(125.01)  |CEILING(-125.99)
---------------+----------------
126            |-125

语法

E()

输入: 无

输出: 2.718281828459045

描述: 返回欧拉数。

SELECT E(), CEIL(E());

       E()       |   CEIL(E())
-----------------+---------------
2.718281828459045|3

EXP

编辑

语法

EXP(numeric_exp)

输入:

浮点数表达式。如果为null，则函数返回null。

输出: 双精度数值

描述: 返回欧拉数的numeric_exp次幂 enumeric_exp。

SELECT EXP(1), E(), EXP(2), E() * E();

     EXP(1)      |       E()       |     EXP(2)     |     E() * E()
-----------------+-----------------+----------------+------------------
2.718281828459045|2.718281828459045|7.38905609893065|7.3890560989306495

EXPM1

编辑

语法

EXPM1(numeric_exp)

输入:

浮点数表达式。如果为null，则函数返回null。

输出: 双精度数值

描述: 返回欧拉数的numeric_exp次幂减1 (enumeric_exp - 1)。

SELECT E(), EXP(2), EXPM1(2);

       E()       |     EXP(2)     |    EXPM1(2)
-----------------+----------------+----------------
2.718281828459045|7.38905609893065|6.38905609893065

FLOOR

编辑

语法

FLOOR(numeric_exp)

输入:

数值表达式。如果为null，则函数返回null。

输出: 整数或长整型数值

描述: 返回小于或等于numeric_exp的最大整数。

SELECT FLOOR(125.01), FLOOR(-125.99);

 FLOOR(125.01) |FLOOR(-125.99)
---------------+---------------
125            |-126

LOG

编辑

语法

LOG(numeric_exp)

输入:

数值表达式。如果为null，则函数返回null。

输出: 双精度数值

描述: 返回numeric_exp的自然对数。

SELECT EXP(3), LOG(20.085536923187668);

      EXP(3)      |LOG(20.085536923187668)
------------------+-----------------------
20.085536923187668|3.0

LOG10

编辑

语法

LOG10(numeric_exp)

输入:

数值表达式。如果为null，则函数返回null。

输出: 双精度数值

描述: 返回numeric_exp的以10为底的对数。

SELECT LOG10(5), LOG(5)/LOG(10);

     LOG10(5)     |    LOG(5)/LOG(10)
------------------+-----------------------
0.6989700043360189|0.6989700043360187

PI

编辑

语法

PI()

输入: 无

输出: 3.141592653589793

描述: 返回圆周率。

SELECT PI();

      PI()
-----------------
3.141592653589793

POWER

编辑

语法

POWER(
    numeric_exp, 
    integer_exp)

输入:

数值表达式。如果为null，则函数返回null。

整数表达式。如果为null，则函数返回null。

输出: 双精度数值

描述: 返回numeric_exp的integer_exp次幂。

SELECT POWER(3, 2), POWER(3, 3);

  POWER(3, 2)  |  POWER(3, 3)
---------------+---------------
9.0            |27.0
SELECT POWER(5, -1), POWER(5, -2);

  POWER(5, -1) |  POWER(5, -2)
---------------+---------------
0.2            |0.04

RANDOM/RAND

编辑

语法

RANDOM(seed)

输入:

数值表达式。如果为null，则函数返回null。

输出: 双精度数值

描述: 使用给定的种子返回一个随机双精度数。

SELECT RANDOM(123);

   RANDOM(123)
------------------
0.7231742029971469

ROUND

编辑

语法

ROUND(
    numeric_exp      
    [, integer_exp])

输入:

数值表达式。如果为null，则函数返回null。

整数表达式；可选。如果为null，则函数返回null。

输出: 数值

描述: 返回numeric_exp四舍五入到小数点右边的integer_exp位。如果integer_exp为负数，则numeric_exp四舍五入到小数点左边的|integer_exp|位。如果省略integer_exp，则函数将执行类似于integer_exp为0的情况。返回的数值数据类型与numeric_exp的数据类型相同。

SELECT ROUND(-345.153, 1) AS rounded;

    rounded
---------------
-345.2
SELECT ROUND(-345.153, -1) AS rounded;

    rounded
---------------
-350.0

SIGN/SIGNUM

编辑

语法

SIGN(numeric_exp)

输入:

数值表达式。如果为null，则函数返回null。

输出: [-1, 0, 1]

描述: 返回numeric_exp符号的指示符。如果numeric_exp小于零，则返回-1。如果numeric_exp等于零，则返回0。如果numeric_exp大于零，则返回1。

SELECT SIGN(-123), SIGN(0), SIGN(415);

  SIGN(-123)   |    SIGN(0)    |   SIGN(415)
---------------+---------------+---------------
-1             |0              |1

SQRT

编辑

语法

SQRT(numeric_exp)

输入:

数值表达式。如果为null，则函数返回null。

输出: 双精度数值

描述: 返回numeric_exp的平方根。

SELECT SQRT(EXP(2)), E(), SQRT(25);

  SQRT(EXP(2))   |       E()       |   SQRT(25)
-----------------+-----------------+---------------
2.718281828459045|2.718281828459045|5.0

TRUNCATE/TRUNC

编辑

语法

TRUNCATE(
    numeric_exp      
    [, integer_exp])

输入:

数值表达式。如果为null，则函数返回null。

整数表达式；可选。如果为null，则函数返回null。

输出: 数值

描述: 返回numeric_exp截断到小数点右边的integer_exp位。如果integer_exp为负数，则numeric_exp截断到小数点左边的|integer_exp|位。如果省略integer_exp，则函数将执行类似于integer_exp为0的情况。返回的数值数据类型与numeric_exp的数据类型相同。

SELECT TRUNC(-345.153, 1) AS trimmed;

    trimmed
---------------
-345.1
SELECT TRUNCATE(-345.153, -1) AS trimmed;

    trimmed
---------------
-340.0

三角函数

编辑

ACOS

编辑

语法

ACOS(numeric_exp)

输入:

数值表达式。如果为null，则函数返回null。

输出: 双精度数值

描述: 返回numeric_exp的反余弦，以弧度表示。

SELECT ACOS(COS(PI())), PI();

 ACOS(COS(PI())) |      PI()
-----------------+-----------------
3.141592653589793|3.141592653589793

ASIN

编辑

语法

ASIN(numeric_exp)

输入:

数值表达式。如果为null，则函数返回null。

输出: 双精度数值

描述: 返回numeric_exp的反正弦，以弧度表示。

SELECT ROUND(DEGREES(ASIN(0.7071067811865475))) AS "ASIN(0.707)", ROUND(SIN(RADIANS(45)), 3) AS "SIN(45)";

  ASIN(0.707)  |    SIN(45)
---------------+---------------
45.0           |0.707

ATAN

编辑

语法

ATAN(numeric_exp)

输入:

数值表达式。如果为null，则函数返回null。

输出: 双精度数值

描述: 返回numeric_exp的反正切，以弧度表示。

SELECT DEGREES(ATAN(TAN(RADIANS(90))));

DEGREES(ATAN(TAN(RADIANS(90))))
-------------------------------
90.0

ATAN2

编辑

语法

ATAN2(
    ordinate, 
    abscisa)

输入:

数值表达式。如果为null，则函数返回null。

数值表达式。如果为null，则函数返回null。

输出: 双精度数值

描述: 返回指定为角度的纵坐标和横坐标的反正切，以弧度表示。

SELECT ATAN2(5 * SIN(RADIANS(45)), 5 * COS(RADIANS(45))) AS "ATAN2(5*SIN(45), 5*COS(45))", RADIANS(45);

ATAN2(5*SIN(45), 5*COS(45))|   RADIANS(45)
---------------------------+------------------
0.7853981633974483         |0.7853981633974483

COS

编辑

语法

COS(numeric_exp)

输入:

数值表达式。如果为null，则函数返回null。

输出: 双精度数值

描述: 返回numeric_exp的余弦，其中numeric_exp是以弧度表示的角度。

SELECT COS(RADIANS(180)), POWER(SIN(RADIANS(54)), 2) + POWER(COS(RADIANS(54)), 2) AS pythagorean_identity;

COS(RADIANS(180))|pythagorean_identity
-----------------+--------------------
-1.0             |1.0

COSH

编辑

语法

COSH(numeric_exp)

输入:

数值表达式。如果为null，则函数返回null。

输出: 双精度数值

描述: 返回numeric_exp的双曲余弦。

SELECT COSH(5), (POWER(E(), 5) + POWER(E(), -5)) / 2 AS "(e^5 + e^-5)/2";

     COSH(5)     | (e^5 + e^-5)/2
-----------------+-----------------
74.20994852478785|74.20994852478783

COT

编辑

语法

COT(numeric_exp)

输入:

数值表达式。如果为null，则函数返回null。

输出: 双精度数值

描述: 返回numeric_exp的余切，其中numeric_exp是以弧度表示的角度。

SELECT COT(RADIANS(30)) AS "COT(30)", COS(RADIANS(30)) / SIN(RADIANS(30)) AS "COS(30)/SIN(30)";

     COT(30)      | COS(30)/SIN(30)
------------------+------------------
1.7320508075688774|1.7320508075688776

DEGREES

编辑

语法

DEGREES(numeric_exp)

输入:

数值表达式。如果为null，则函数返回null。

输出: 双精度数值

描述: 将弧度转换为度。

SELECT DEGREES(PI() * 2), DEGREES(PI());

DEGREES(PI() * 2)| DEGREES(PI())
-----------------+---------------
360.0            |180.0

RADIANS

编辑

语法

RADIANS(numeric_exp)

输入:

数值表达式。如果为null，则函数返回null。

输出: 双精度数值

描述: 将度转换为弧度。

SELECT RADIANS(90), PI()/2;

   RADIANS(90)    |      PI()/2
------------------+------------------
1.5707963267948966|1.5707963267948966

SIN

编辑

语法

SIN(numeric_exp)

输入:

数值表达式。如果为null，则函数返回null。

输出: 双精度数值

描述: 返回numeric_exp的正弦，其中numeric_exp是以弧度表示的角度。

SELECT SIN(RADIANS(90)), POWER(SIN(RADIANS(67)), 2) + POWER(COS(RADIANS(67)), 2) AS pythagorean_identity;

SIN(RADIANS(90))|pythagorean_identity
----------------+--------------------
1.0             |1.0

SINH

编辑

语法

SINH(numeric_exp)

输入:

数值表达式。如果为null，则函数返回null。

输出: 双精度数值

描述: 返回numeric_exp的双曲正弦。

SELECT SINH(5), (POWER(E(), 5) - POWER(E(), -5)) / 2 AS "(e^5 - e^-5)/2";

     SINH(5)     | (e^5 - e^-5)/2
-----------------+-----------------
74.20321057778875|74.20321057778874

TAN

编辑

语法

TAN(numeric_exp)

输入:

数值表达式。如果为null，则函数返回null。

输出: 双精度数值

描述: 返回numeric_exp的正切，其中numeric_exp是以弧度表示的角度。

SELECT TAN(RADIANS(66)) AS "TAN(66)", SIN(RADIANS(66))/COS(RADIANS(66)) AS "SIN(66)/COS(66)=TAN(66)";

     TAN(66)      |SIN(66)/COS(66)=TAN(66)
------------------+-----------------------
2.2460367739042164|2.246036773904216
« 全文搜索函数 字符串函数 »