IoT Platform:数学関数

構文

bigint|double|decimal abs(<number>)

説明

number の絶対値を計算します。

パラメーター

戻り値

例

構文

double|decimal acos(<number>)

説明

number の逆余弦を計算します。

パラメーター

number: 必須。値の範囲は -1 から 1 です。DOUBLE 型または DECIMAL 型の値。入力値の型が STRING または BIGINT の場合、計算前に値は暗黙的に DOUBLE 型の値に変換されます。

戻り値

例

構文

double atan2(<expr1>, <expr2>)

説明

expr1 と expr2 の逆正接を計算します。

パラメーター

• expr1: 必須。値の型は DOUBLE です。入力値の型が STRING、BIGINT、または DECIMAL の場合、計算前に値は暗黙的に DOUBLE 型の値に変換されます。

• expr2: 必須。DOUBLE 型の値。入力値の型が STRING、BIGINT、または DECIMAL の場合、計算前に値は暗黙的に DOUBLE 型の値に変換されます。

戻り値

DOUBLE 型の値が返されます。戻り値の範囲は -π/2 から π/2 です。expr1 または expr2 の値が null の場合、null が返されます。

例

-- 値 0.0 が返されます。
select atan2(0, 0);

構文

double|decimal asin(<number>)

説明

number の逆正弦を計算します。

パラメーター

number: 必須。値の範囲は -1 から 1 です。DOUBLE 型または DECIMAL 型の値。入力値の型が STRING または BIGINT の場合、計算前に値は暗黙的に DOUBLE 型の値に変換されます。

戻り値

例

構文

double atan(<number>)

説明

number の逆正接を計算します。

パラメーター

number: 必須。DOUBLE 型の値。入力値の型が STRING、BIGINT、または DECIMAL の場合、計算前に値は暗黙的に DOUBLE 型の値に変換されます。

戻り値

DOUBLE 型の値が返されます。戻り値の範囲は -π/2 から π/2 です。number の値が null の場合、null が返されます。

例

構文

bigint ceil(<value>)

説明

value を繰り上げて、最も近い整数を返します。

パラメーター

value: 必須。値の型は DOUBLE または DECIMAL です。入力値の型が STRING または BIGINT の場合、計算前に値は暗黙的に DOUBLE 型の値に変換されます。

戻り値

BIGINT 型の値が返されます。number の値が null の場合、null が返されます。

例

構文

string conv(<input>, bigint <from_base>, bigint <to_base>)

説明

ある記数法の数値を別の記数法の数値に変換します。

パラメーター

• input: 必須。値は変換する整数で、STRING 型です。入力値の型が BIGINT または DOUBLE の場合、計算前に値は暗黙的に STRING 型の値に変換されます。

• from_base と to_base: 必須。これらのパラメーターの値は 10 進数です。値は 2、8、10、または 16 にすることができます。入力値の型が STRING または DOUBLE の場合、計算前に値は暗黙的に BIGINT 型の値に変換されます。

戻り値

例

構文

double corr(<col1>, <col2>)

説明

2 つのデータ列のピアソンの相関係数を計算します。

パラメーター

col1 と col2: 必須。ピアソンの相関係数を計算する 2 つの列の名前。値の型は DOUBLE、BIGINT、INT、SMALLINT、TINYINT、FLOAT、または DECIMAL です。col1 列と col2 列のデータは、異なるデータ型にすることができます。

戻り値

DOUBLE 型の値が返されます。入力列の行に null 値がある場合、その行は計算に含まれません。

構文

double|decimal cos(<number>)

説明

ラジアン値である number の余弦を計算します。

パラメーター

number: 必須。値の型は DOUBLE または DECIMAL です。入力値の型が STRING または BIGINT の場合、計算前に値は暗黙的に DOUBLE 型の値に変換されます。

戻り値

例

構文

double|decimal cosh(<number>)

説明

number の双曲線余弦を計算します。

パラメーター

number: 必須。値の型は DOUBLE または DECIMAL です。入力値の型が STRING または BIGINT の場合、計算前に値は暗黙的に DOUBLE 型の値に変換されます。

戻り値

例

構文

double|decimal cot(<number>)

説明

ラジアン値である number の余接を計算します。

パラメーター

number: 必須。値の型は DOUBLE または DECIMAL です。入力値の型が STRING または BIGINT の場合、計算前に値は暗黙的に DOUBLE 型の値に変換されます。

戻り値

例

構文

double degrees(<number>) 

説明

この関数は、ラジアン値を度に変換します。

パラメーター

number: 必須。値の型は DOUBLE、BIGINT、INT、SMALLINT、TINYINT、FLOAT、DECIMAL、または STRING です。

戻り値

DOUBLE 型の値が返されます。number の値が null の場合、null が返されます。

例

構文

double e()

説明

e の値を計算します。

戻り値

DOUBLE 型の値が返されます。

例

-- 値 2.718281828459045 が返されます。
select e();

構文

double|decimal exp(<number>)

説明

number の指数値を計算します。

パラメーター

number: 必須。値の型は DOUBLE または DECIMAL です。入力値の型が STRING または BIGINT の場合、計算前に値は暗黙的に DOUBLE 型の値に変換されます。

戻り値

例

構文

bigint floor(<number>)

説明

number の値を繰り下げて、 number の値以下の最も近い整数を返します。

パラメーター

number: 必須。値の型は DOUBLE または DECIMAL です。入力値の型が STRING または BIGINT の場合、計算前に値は暗黙的に DOUBLE 型の値に変換されます。

戻り値

BIGINT 型の値が返されます。number の値が null の場合、null が返されます。

例

構文

string format_number(float|double|decimal <expr1>, <expr2>)

説明

この関数は、数値を指定された形式の文字列に変換します。

パラメーター

• expr1: 必須。このパラメーターは、指定された形式に変換する式を指定します。DOUBLE、BIGINT、INT、SMALLINT、TINYINT、FLOAT、DECIMAL、または STRING 型の値。

• expr2: 必須。このパラメーターは、変換後の式の形式を指定します。パラメーターでは、保持する小数点以下の桁数を指定できます。パラメーターは、#,###,###.## のような形式にすることもできます。

戻り値

例

構文

boolean isnan(<expr>)

説明

expr の値が NaN かどうかを確認します。

パラメーター

expr: 必須。DOUBLE 型の値。入力値の型が STRING、BIGINT、または DECIMAL の場合、計算前に値は暗黙的に DOUBLE 型の値に変換されます。

戻り値

• expr の値が NaN の場合、True が返されます。それ以外の場合、False が返されます。

• expr の値が null の場合、False が返されます。

例

-- 値 False が返されます。
SELECT isnan(100.1);

構文

double|decimal ln(<number>)

説明

number の自然対数を計算します。

パラメーター

number: 必須。値の型は DOUBLE または DECIMAL です。入力値の型が STRING または BIGINT の場合、計算前に値は暗黙的に DOUBLE 型の値に変換されます。

戻り値

例

構文

double log(<base>, <x>)

説明

底が base の値である x の対数を計算します。

パラメーター

• base: 必須。底。値の型は DOUBLE または DECIMAL です。入力値の型が STRING または BIGINT の場合、計算前に値は暗黙的に DOUBLE 型の値に変換されます。

• x: 必須。対数を計算する値。値の型は DOUBLE または DECIMAL です。入力値の型が STRING または BIGINT の場合、計算前に値は暗黙的に DOUBLE 型の値に変換されます。

戻り値

例

構文

double log10(<number>)

説明

底が 10 である number の対数を計算します。

パラメーター

number: 必須。値の型は DOUBLE、BIGINT、INT、SMALLINT、TINYINT、FLOAT、DECIMAL、または STRING です。

戻り値

DOUBLE 型の値が返されます。number の値が 0、負の値、または null の場合、null が返されます。

例

構文

double log2(<number>)

説明

底が 2 である number の対数を計算します。

パラメーター

number: 必須。値の型は DOUBLE、BIGINT、INT、SMALLINT、TINYINT、FLOAT、DECIMAL、または STRING です。

戻り値

DOUBLE 型の値が返されます。number の値が 0、負の値、または null の場合、null が返されます。

例

構文

TINYINT|SMALLINT|INT|BIGINT|DOUBLE|DECIMAL negative(TINYINT|SMALLINT|INT|BIGINT|DOUBLE|DECIMAL <expr>)

説明

expr の負の値を返します。

パラメーター

expr: 必須。値は、TINYINT、SMALLINT、INT、BIGINT、DOUBLE、または DECIMAL 型の式です。

戻り値

expr の負の値が返されます。

例

-- 値 1 が返されます。
SELECT negative(1);

構文

double pi()

説明

この関数は、π の値を計算します。

戻り値

DOUBLE 型の値が返されます。

例

-- 値 3.141592653589793 が返されます。
select pi();

構文

TINYINT|SMALLINT|INT|BIGINT|DOUBLE|DECIMAL positive(TINYINT|SMALLINT|INT|BIGINT|DOUBLE|DECIMAL <expr>)

説明

expr の値を返します。

パラメーター

expr: 必須。値は、TINYINT、SMALLINT、INT、BIGINT、DOUBLE、または DECIMAL 型の式です。

戻り値

expr の値が返されます。

例

-- 戻り値は 1 です。
SELECT positive(1);

構文

double|decimal pow(<x>, <y>)

説明

x の y 乗、つまり x^y を計算します。

パラメーター

• x: 必須。値の型は DOUBLE または DECIMAL です。入力値の型が STRING または BIGINT の場合、計算前に値は暗黙的に DOUBLE 型の値に変換されます。

• y: 必須。値の型は DOUBLE または DECIMAL です。入力値の型が STRING または BIGINT の場合、計算前に値は暗黙的に DOUBLE 型の値に変換されます。

戻り値

例

構文

double radians(<number>)

説明

この関数は、度をラジアン値に変換します。

パラメーター

number: 必須。値の型は DOUBLE、BIGINT、INT、SMALLINT、TINYINT、FLOAT、DECIMAL、または STRING です。

戻り値

DOUBLE 型の値が返されます。number の値が null の場合、null が返されます。

例

構文

double rand(bigint <seed>)

説明

DOUBLE 型の乱数を返します。値の範囲は 0 から 1 です。

パラメーター

seed: オプション。値の型は BIGINT です。このパラメーターは、乱数シーケンスの開始点を決定する乱数シードを指定します。

戻り値

DOUBLE 型の値が返されます。

例

-- 値 4.7147460303803655E-4 が返されます。
select rand();
-- 値 0.7308781907032909 が返されます。
select rand(1);

構文

double|decimal round(<number>[, bigint <decimal_places>])

説明

指定された小数点以下の桁数に丸められた数値を返します。

パラメーター

• number: 必須。DOUBLE 型または DECIMAL 型の値。入力値の型が STRING または BIGINT の場合、計算前に値は暗黙的に DOUBLE 型の値に変換されます。

• decimal_places: オプション。値は BIGINT 型の定数です。このパラメーターは、数値を丸める小数点以下の桁数を指定します。このパラメーターを設定しない場合、数値は 1 の位に丸められます。デフォルト値は 0 です。

  説明

  decimal_places の値は負の値にすることができます。負の値は、小数点から左に数えることを示し、小数部分は除外されます。decimal_places の値が整数部分の長さを超える場合、0 が返されます。

戻り値

例

構文

int shiftleft(tinyint|smallint|int <number1>, int <number2>)
bigint shiftleft(bigint <number1>, int <number2>)

説明

値を指定された桁数だけ左にシフトします (<<)。

パラメーター

• number1: 必須。値の型は TINYINT、SMALLINT、INT、または BIGINT です。

• number2: 必須。値の型は INT です。

戻り値

例

構文

int shiftright(tinyint|smallint|int <number1>, int <number2>)
bigint shiftright(bigint <number1>, int <number2>)

説明

値を指定された桁数だけ右にシフトします (>>)。

パラメーター

• number1: 必須。値の型は TINYINT、SMALLINT、INT、または BIGINT です。

• number2: 必須。値の型は INT です。

戻り値

例

構文

int shiftrightunsigned(tinyint|smallint|int <number1>, int <number2>)
bigint shiftrightunsigned(bigint <number1>, int <number2>)

説明

符号なし値を指定された桁数だけ右にシフトします (>>>)。

パラメーター

• number1: 必須。値は TINYINT、SMALLINT、INT、または BIGINT 型の整数です。

• number2: 必須。値は INT 型の整数です。

戻り値

例

構文

double sign(<number>)

説明

入力値の符号を返します。

パラメーター

number: 必須。値の型は DOUBLE、BIGINT、INT、SMALLINT、TINYINT、FLOAT、DECIMAL、または STRING です。

戻り値

例

構文

double|decimal sin(<number>)

説明

ラジアン値である number の正弦を計算します。

パラメーター

number: 必須。値の型は DOUBLE または DECIMAL です。入力値の型が STRING または BIGINT の場合、計算前に値は暗黙的に DOUBLE 型の値に変換されます。

戻り値

例

構文

double|decimal sinh(<number>)

説明

number の双曲線正弦を計算します。

パラメーター

number: 必須。値の型は DOUBLE または DECIMAL です。入力値の型が STRING または BIGINT の場合、計算前に値は暗黙的に DOUBLE 型の値に変換されます。

戻り値

例

構文

double|decimal sqrt(<number>)

説明

number の値の平方根を計算します。

パラメーター

number: 必須。値の型は DOUBLE または DECIMAL です。値は 0 より大きくなければなりません。値が 0 未満の場合、null が返されます。入力値の型が STRING または BIGINT の場合、計算前に値は暗黙的に DOUBLE 型の値に変換されます。

戻り値

例

構文

double|decimal tan(<number>)

説明

ラジアン値である number の正接を計算します。

パラメーター

number: 必須。値の型は DOUBLE または DECIMAL です。入力値の型が STRING または BIGINT の場合、計算前に値は暗黙的に DOUBLE 型の値に変換されます。

戻り値

例

構文

double|decimal tanh(<number>)

説明

number の双曲線正接を計算します。

パラメーター

number: 必須。値の型は DOUBLE または DECIMAL です。入力値の型が STRING または BIGINT の場合、計算前に値は暗黙的に DOUBLE 型の値に変換されます。

戻り値

例