Analytics SAQL リファレンス
j算術関数
SAQL クエリで数値演算を実行するには、算術関数を使用します。
SAQL 算術関数は、foreach ステートメント、および foreach ステートメントの後の filter by 句で使用できます。
group by 句または order by 句では算術関数を使用できません。foreach ステートメントの前の filter by 句で算術関数を使用することもできませんが、foreach ステートメントの後なら使用できます。
関数
次に、サポートされている SAQL 算術関数のリストを示します。
abs(n)
n の絶対数を数値として返します。n には、範囲が -1e308 <= n <= 1e308 の任意の実数値を指定できます。
次の例は有効です。
次の例は無効です。
ceil(n)
n 以上で最も近い整数値を返します。n には、範囲が -1e308 <= n <= 1e308 の任意の実数値を指定できます。
次の例は有効です。
次の例は無効です。
floor(n)
n 以下で最も近い整数値を返します。n には、範囲が -1e308 <= n <= 1e308 の任意の実数値を指定できます。
次の例は有効です。
次の例は無効です。
trunc(n[, m])
数値式 n を小数点以下第 m 位で切り捨てた値を返します。m には負の数を指定できます。その場合、この関数では小数点の左側 m 桁以下を切り捨てた n を返します。m が省略された場合は、小数点以下を切り捨てた n を返します。n には、範囲が -1e308 <= n <= 1e308 の任意の実数値を指定できます。m には、-15 ～ 15 の整数値を指定できます。
次の例は有効です。
次の例は無効です。
round(n[, m])
n を小数点以下第 m 位に四捨五入した値を返します。m には負の数を指定できます。その場合、この関数では小数点の左側 m 桁以下を四捨五入した n を返します。m が省略された場合は、最も近い整数に四捨五入した n を返します。0 を基準にして半分 (0.5 未満) が切り捨て、0.5 以上が切り上げになります。n には、範囲が -1e308 <= n <= 1e308 の任意の実数値を指定できます。m には、-15 ～ 15 の整数値を指定できます。
次の例は有効です。
次の例は無効です。
exp(n)
n の累乗まで乗算したオイラーの数値 e の値を返します。ここで、e = 2.71828183…です。0 にならない n の最小値は 3e-324 です。n には、範囲が -1e308 <= n <= 700 の任意の実数値を指定できます。
次の例は有効です。
次の例は無効です。
log(m, n)
数値 n の自然対数 (基数 m) を返します。値 m と n には、範囲が 0 < m、n <= 1e308 および m ≠ 1 の任意の 0 でない正の数値を指定できます。
m で許可される最小数値入力は >0、m!=1 です。0 にならない m または n の最小数値は log(10, 0.3e-323) です。
次の例は有効です。
次の例は無効です。
power(m, n)
n 番目の累乗まで乗算した m を返します。m、n には、範囲が -1e308 <= m、n <= 1e308 の任意の数値を指定できます。m = 0 で n < 0 の場合は null を返します。
- m = 0 の場合、n は負でない値である必要があります。
- m < 0 の場合、n は整数値である必要があります。
- power(m, n) の結果は、float64 の数値で表される範囲内である必要があります。
次の例は有効です。
次の例は無効です。
sqrt(n)
数値 n の平方根を返します。値 n には、範囲が 0 <= n <= 1e308 の任意の負でない数値を指定できます。
次の例は有効です。
次の例は無効です。