OceanBase 数学函数
ROUND
声明
ROUND(X), ROUND(X,D)
说明
返回一个数值，四舍五入到指定的长度或精度。
返回参数 X, 其值接近于最近似的整数。在有两个参数的情况下，返回 X，其值保留到小数点后 D 位，而第 D 位的保留方式为四舍五入。若要接保留 X 值小数点左边的 D 位，可将 D 设为负值。
返回值的类型同第一个自变量相同（假设它是一个整数、双精度数或小数）。这意味着对于一个整数参数，结果也是一个整数（无小数部分）。
对于准确值数字，
ROUND()使用“四舍五入”或“舍入成最接近的数”的规则：对于一个分数部分为 .5 或大于 .5 的值，正数则上舍入到邻近的整数值，负数则下舍入临近的整数值。（换言之, 其舍入的方向是数轴上远离零的方向）。对于一个分数部分小于 .5 的值，正数则下舍入下一个整数值，负数则下舍入邻近的整数值，而正数则上舍入邻近的整数值。
对于近似值数字，
ROUND()遵循“四舍--大于五入--五取最接近的偶数”的规则：一个带有任何小数部分的值会被舍入成最接近的偶数整数。
例子
obclient> select round(2.15,2);
+---------------+
| round(2.15,2) |
+---------------+
| 2.15 |
+---------------+
1 row in set (0.00 sec)
obclient> select round(2555e-2,1);
+------------------+
| round(2555e-2,1) |
+------------------+
| 25.6 |
+------------------+
1 row in set (0.01 sec)
obclient> select round(25e-1), round(25.3e-1),round(35e-1);
+--------------+----------------+--------------+
| round(25e-1) | round(25.3e-1) | round(35e-1) |
+--------------+----------------+--------------+
| 2 | 3 | 4 |
+--------------+----------------+--------------+
1 row in set (0.00 sec)CEIL
声明
CEIL(expr)
说明
返回大于或者等于指定表达式的最小整数。
还支持比较运算，结果为 BOOL 值，被转化为数字类型处理，产生的结果为 1(TRUE)、0 (FALSE)。
如果输入 NULL，返回值为 NULL。
如果输入纯数字的字符串，支持自动转换成数字类型。
返回值会被转化为一个 BIGINT。
例子
obclient> select ceil(1.2), ceil(-1.2), ceil(1+1.5), ceil(1=1),ceil(1<1),ceil(null);
+-----------+------------+-------------+-----------+-----------+------------+
| ceil(1.2) | ceil(-1.2) | ceil(1+1.5) | ceil(1=1) | ceil(1<1) | ceil(null) |
+-----------+------------+-------------+-----------+-----------+------------+
| 2 | -1 | 3 | 1 | 0 | NULL |
+-----------+------------+-------------+-----------+-----------+------------+
1 row in set (0.00 sec)
obclient> select ceil(name);
ERROR 1054 (42S22): Unknown column 'name' in 'field list'
obclient> select ceil('2');
+-----------+
| ceil('2') |
+-----------+
| 2 |
+-----------+
1 row in set (0.00 sec)FLOOR
声明
FLOOR(expr)
说明
和 CEIL(expr) 函数功能类似，返回小于或者等于指定表达式的最大整数。
还支持比较运算，结果为 BOOL 值，被转化为数字类型处理，产生的结果为 1(TRUE)、0 (FALSE)。
如果输入 NULL，返回值为 NULL。
如果输入纯数字的字符串，支持自动转换成数字类型。
返回值会被转化为一个 BIGINT。
例子
obclient> select floor(1.2), floor(-1.2), floor(1+1.5), floor(1=1),floor(1<1),floor(null);
+------------+-------------+--------------+------------+------------+-------------+
| floor(1.2) | floor(-1.2) | floor(1+1.5) | floor(1=1) | floor(1<1) | floor(null) |
+------------+-------------+--------------+------------+------------+-------------+
| 1 | -2 | 2 | 1 | 0 | NULL |
+------------+-------------+--------------+------------+------------+-------------+
1 row in set (0.00 sec)
obclient> select floor(name);
ERROR 1054 (42S22): Unknown column 'name' in 'field list'
obclient> select floor('2');
+------------+
| floor('2') |
+------------+
| 2 |
+------------+
1 row in set (0.00 sec)ABS
声明
ABS(expr)
说明
绝对值函数，求表达式绝对值，函数返回值类型与数值表达式的数据类型相同。
还支持比较运算，结果为 BOOL 值，被转化为数字类型处理，产生的结果为 1(TRUE)、0 (FALSE)。
如果输入 NULL，返回值为 NULL。
如果输入纯数字的字符串，支持自动转换成数字类型。
返回值会被转化为一个 BIGINT。
例子
obclient> select abs(5), abs(-5.777), abs(0), abs(1/2), abs(1-5);
+--------+-------------+--------+----------+----------+
| abs(5) | abs(-5.777) | abs(0) | abs(1/2) | abs(1-5) |
+--------+-------------+--------+----------+----------+
| 5 | 5.777 | 0 | 0.5000 | 4 |
+--------+-------------+--------+----------+----------+
1 row in set (0.00 sec)NEG
声明
NEG(expr)
说明
求补函数，对操作数执行求补运算：用零减去操作数，然后结果返回操作数。
支持比较运算，结果为 BOOL 值，被转化为数字类型处理，产生的结果为 1(TRUE)、0 (FALSE)，再对结果求补。
例子
obclient> select neg(1), neg(1+1), neg(2*3), neg(1=1), neg(5<1);
+--------+----------+----------+----------+----------+
| neg(1) | neg(1+1) | neg(2*3) | neg(1=1) | neg(5<1) |
+--------+----------+----------+----------+----------+
| -1 | -2 | -6 | -1 | 0 |
+--------+----------+----------+----------+----------+
1 row in set (0.01 sec)SIGN
声明
SIGN(X)
说明
SIGN(X) 返回参数作为 -1、 0 或 1 的符号，该符号取决于 X 的值为负、零或正。
支持比较运算，结果为 BOOL 值，被转化为数字类型处理，产生的结果为 1(TRUE)、0 (FALSE)。
如果输入 NULL，返回值为 NULL。
支持浮点数、十六进制数。
例子
obclient> SELECT SIGN(-32), SIGN(0), SIGN(234);
+-----------+---------+-----------+
| SIGN(-32) | SIGN(0) | SIGN(234) |
+-----------+---------+-----------+
| -1 | 0 | 1 |
+-----------+---------+-----------+
1 row in set (0.01 sec)
obclient> select sign(null),sign(false),sign(0x01);
+------------+-------------+------------+
| sign(null) | sign(false) | sign(0x01) |
+------------+-------------+------------+
| NULL | 0 | 1 |
+------------+-------------+------------+
1 row in set (0.00 sec)CONV
声明
CONV(N, from_base, to_base)
说明
不同数基间转换数字。返回值为一个字符串，由 from_base 基转化为 to_base 基。输入参数 N 可以是一个整数或字符串。最小基数为 2，而最大基数则为 36。如果 to_base 是一个负数，则 N 被看作一个带符号数。否则，N 被看作无符号数。from_base 如果是负数，则被当作整数处理，符号被忽略。N 参数仅支持 int 类型和字符串类型输入；from_base 和 to_base 参数仅支持十进制 int 类型输入，且取值范围为 [-36, -2] U [2, 36]。
非法输入将导致报错，其中非法输入包括以下情况：
from_base或者to_base不是一个合法的十进制 int 类型输入；
from_base或者to_base超出 [-36,-2] U [2,36] 的取值范围；
N不是一个合法的数字表示，例如取值超出 0～9，a～z，A～Z 的字符范围；
N超出了from_base基的取值范围，例如from_base为 2，而N取值为 3；
N的取值超出了 int64 的最大表示范围，即 [-9223372036854775807, 9223372036854775807]。
例子
obclient> select conv(9223372036854775807,10,2);
+-----------------------------------------------------------------+
| conv(9223372036854775807,10,2) |
+-----------------------------------------------------------------+
| 111111111111111111111111111111111111111111111111111111111111111 |
+-----------------------------------------------------------------+
1 row in set (0.00 sec)
obclient> select conv('-acc',21,-7);
+--------------------+
| conv('-acc',21,-7) |
+--------------------+
| -16425 |
+--------------------+
1 row in set (0.00 sec)MOD
声明
MOD(N,M)
说明
取余函数。MOD(N,M)， N % M， N MOD M 三种形式是等效的。
MOD() 对于带有小数部分的数值也起作用，它返回除法运算后的精确余数。
N,M 中任何一个参数为 NULL，返回值都为 NULL。M 为 0 时，也返回 NULL。
例子
obclient> select mod(29,19), 29 mod 19, 29 % 19;
+------------+-----------+---------+
| mod(29,19) | 29 mod 19 | 29 % 19 |
+------------+-----------+---------+
| 10 | 10 | 10 |
+------------+-----------+---------+
1 row in set (0.00 sec)POW
声明
POW(X,Y)
说明
返回 X 的 Y 次方。
X 与 Y 中任何一个参数为 NULL，返回值都为 NULL。
例子
obclient> select pow(4,2), pow(4,-2), pow(1,null);
+----------+-----------+-------------+
| pow(4,2) | pow(4,-2) | pow(1,null) |
+----------+-----------+-------------+
| 16 | 0.0625 | NULL |
+----------+-----------+-------------+
1 row in set (0.00 sec)POWER
声明
POWER(X,Y)
说明
POWER(X,Y) 和 POW(X,Y) 是同义函数。
RAND
声明
RAND([N])
说明
RAND([N]) 函数接受 0 个或者 1 个参数（N 被称为随机数种子），返回一个范围是 [0,1.0) 的随机浮点数。如果想获得一个范围在 [i, j) 的随机整数，可以使用表达式 FLOOR(I + RAND() * (j - i))。
如果参数 N 不指定，那么在执行之前会使用随机种子初始化，之后 RAND() 会根据这个初始化值来生成随机数，所以 RAND() 每次会生成不同的随机数序列。
如果参数 N 指定，那么 N 会作为随机数种子来生成随机数。根据 N 是否是常量，分成以下两种情况：
如果
N是常量，那么N在执行之前会被当成随机种子初始化，之后RAND(N)会根据这个初始化值来生成随机数。相同的N值会生成相同的随机数序列。
如果
N是变量（比如N是一个列值），那么N会在每次执行的时候作为随机数种子来生成随机数。相同的N值会生成相同的随机数。
除了出现在 SECLET 语句中，RAND([N]) 也可以出现在 WHERE，ORDER BY 和 GROUP BY 语句中，它的执行方式还是按照上述规则执行。比如，如果想随机的对一个表进行排序，可以使用如下 SQL：select from t1 order by rand()。如果想随机取样一个表的 100 行，可以使用如下 SQL：select from t1 order by rand() limit 100。
例子
obclient> select a, b, rand() from t3;
+------+------+---------------------+
| a | b | rand() |
+------+------+---------------------+
| 1 | 1 | 0.641815407799385 |
| 2 | 2 | 0.16825051248841966 |
| 3 | 3 | 0.9158063697775886 |
+------+------+---------------------+
3 rows in set (0.00 sec)
obclient> select a, b, rand() from t3;
+------+------+---------------------+
| a | b | rand() |
+------+------+---------------------+
| 1 | 1 | 0.07428034215632857 |
| 2 | 2 | 0.6239826321825224 |
| 3 | 3 | 0.897072165177271 |
+------+------+---------------------+
3 rows in set (0.00 sec)
obclient> select a, b, rand(3) from t3;
+------+------+---------------------+
| a | b | rand(3) |
+------+------+---------------------+
| 1 | 1 | 0.9057697559760601 |
| 2 | 2 | 0.37307905813034536 |
| 3 | 3 | 0.14808605345719125 |
+------+------+---------------------+
3 rows in set (0.00 sec)
obclient> select a, b, rand(3) from t3;
+------+------+---------------------+
| a | b | rand(3) |
+------+------+---------------------+
| 1 | 1 | 0.9057697559760601 |
| 2 | 2 | 0.37307905813034536 |
| 3 | 3 | 0.14808605345719125 |
+------+------+---------------------+
3 rows in set (0.00 sec)
obclient> select a, b, rand(a), rand(b) from t3;
+------+------+---------------------+---------------------+
| a | b | rand(a) | rand(b) |
+------+------+---------------------+---------------------+
| 1 | 1 | 0.40540353712197724 | 0.40540353712197724 |
| 2 | 2 | 0.6555866465490187 | 0.6555866465490187 |
| 3 | 3 | 0.9057697559760601 | 0.9057697559760601 |
+------+------+---------------------+---------------------+
3 rows in set (0.00 sec)