Calculates the yth power of x, namely, x^y.
Syntax
double|decimal pow(<x>, <y>)Parameters
x: required. A value of the DOUBLE or DECIMAL type. If the input value is of the STRING or BIGINT type, the value is implicitly converted into a value of the DOUBLE type before calculation.
y: required. A value of the DOUBLE or DECIMAL type. If the input value is of the STRING or BIGINT type, the value is implicitly converted into a value of the DOUBLE type before calculation.
Return value
A value of the DOUBLE or DECIMAL type is returned. The return value varies based on the following rules:
If x or y is of the DOUBLE or DECIMAL type, a value of the same type is returned.
If x or y is of the STRING or BIGINT type, a value of the DOUBLE type is returned.
If the value of x or y is null, null is returned.
Sample data
This section provides sample source data and examples for you to understand how to use the functions. In this topic, a table named mf_math_fun_t is created and data is inserted into the table. Sample statements:
create table if not exists mf_math_fun_t(
int_data int,
bigint_data bigint,
double_data double,
decimal_data decimal,
float_data float,
string_data string
);
insert into mf_math_fun_t values
(null, -10, 0.525, 0.525BD, cast(0.525 as float), '10'),
(-20, null, -0.1, -0.1BD, cast(-0.1 as float), '-10'),
(0, -1, null, 20.45BD, cast(-1 as float), '30'),
(-40, 4, 0.89, null, cast(0.89 as float), '-30'),
(5, -50, -1, -1BD, null, '50'),
(-60, 6, 1.5, 1.5BD, cast(1.5 as float), '-50'),
(-1, -70, -7.5, -7.5BD, cast(-7.5 as float),null ),
(-80, 1, -10.2, -10.2BD, cast(-10.2 as float), '-1' ),
(9, -90, 2.58, 2.58BD, cast(2.58 as float), '0'),
(-100, 10, -5.8, -5.8BD, cast(-5.8 as float), '-90');Query data from the mf_math_fun_t table. Sample statement:
select * from mf_math_fun_t;
-- The following result is returned:
+------------+-------------+-------------+--------------+------------+-------------+
| int_data | bigint_data | double_data | decimal_data | float_data | string_data |
+------------+-------------+-------------+--------------+------------+-------------+
| NULL | -10 | 0.525 | 0.525 | 0.525 | 10 |
| -20 | NULL | -0.1 | -0.1 | -0.1 | -10 |
| 0 | -1 | NULL | 20.45 | -1.0 | 30 |
| -40 | 4 | 0.89 | NULL | 0.89 | -30 |
| 5 | -50 | -1.0 | -1 | NULL | 50 |
| -60 | 6 | 1.5 | 1.5 | 1.5 | -50 |
| -1 | -70 | -7.5 | -7.5 | -7.5 | NULL |
| -80 | 1 | -10.2 | -10.2 | -10.2 | -1 |
| 9 | -90 | 2.58 | 2.58 | 2.58 | 0 |
| -100 | 10 | -5.8 | -5.8 | -5.8 | -90 |
+------------+-------------+-------------+--------------+------------+-------------+Example: static data
-- The return value is 65536.0.
select pow(2, 16);
-- The return value is null.
select pow(2, null);Example: table data
Calculate the second power of values in a column based on the Sample data. Sample statement:
select pow(bigint_data, 2) as bigint_new, pow(double_data, 2) as double_new, pow(decimal_data, 2) as decimal_new, pow(string_data, 2) as string_new from mf_math_fun_t;The following result is returned:
+------------+----------------------+----------------------+------------+
| bigint_new | double_new | decimal_new | string_new |
+------------+----------------------+----------------------+------------+
| 100.0 | 0.275625 | 0.275625 | 100.0 |
| NULL | 0.010000000000000002 | 0.010000000000000002 | 100.0 |
| 1.0 | NULL | 418.2025 | 900.0 |
| 16.0 | 0.7921 | NULL | 900.0 |
| 2500.0 | 1.0 | 1.0 | 2500.0 |
| 36.0 | 2.25 | 2.25 | 2500.0 |
| 4900.0 | 56.25 | 56.25 | NULL |
| 1.0 | 104.03999999999999 | 104.03999999999999 | 1.0 |
| 8100.0 | 6.6564000000000005 | 6.6564000000000005 | 0.0 |
| 100.0 | 33.64 | 33.64 | 8100.0 |
+------------+----------------------+----------------------+------------+Related functions
POW is a mathematical function. For more information about functions related to data computing and conversion, see Mathematical functions.