カスタム計算関数リファレンス

このページでは、AI/BI ダッシュボードのカスタム計算でサポートされているすべての関数の完全なリファレンスを提供します。カスタム計算の使用方法については、「カスタム計算とは」を参照してください。

集計関数

計算されたすべての測定値を集計する必要があります。次の集計操作がサポートされています。

注

集計関数で DISTINCT キーワードを使用して、集計に一意の値のみを含めます。さらに、 FILTER(WHERE condition) 句を任意の集計関数に追加して、計算に含まれる値を制限できます。

機能	Description
any(expr)	グループ内の`true`の少なくとも 1 つの値が`expr`場合に`true`を返します。
any_value(expr)	行のグループに対して`expr`のいくつかの値を返します。
approx_count_distinct(expr[, relativeSD])	`expr`内の個別の値の推定数を返します。
approx_percentile ([ALL \|DISTINCT] expr, percentile [, accuracy])	指定したパーセンタイルでの `expr` のおおよそのパーセンタイル値を返します。
avg(expr)	列または式の計算平均を返します。
bool_or(expr)	`true`の少なくとも 1 つの値が`expr`されている場合は、`true`を返します。
corr(expr1, expr2)	`expr1`と`expr2`の間のピアソン相関係数を返します。
count(*)	グループ内の行数を返します。
count(DISTINCT expr)	グループ内の一意の行の数を返します。
count_if(expr)	指定された条件を満たす行の数を返します。
first(expr [, ignoreNull])	グループの `expr` の最初の値を返します。
first_value(expr [, ignoreNull])	グループの `expr` の最初の値を返します。
last(expr [, ignoreNull]) (最後の要素を取得する関数で、ignoreNull の指定によりNULLを無視します)	グループの `expr` の最後の値を返します。
last_value(expr [, ignoreNull])	グループの `expr` の最後の値を返します。
listagg(expr [, delimiter])	グループ内の null 以外の値の連結を返します。
max(expr)	列または式の最大値を返します。
max_by(expr1, expr2)	`expr1`の最大値に関連付けられている`expr2`の値を返します。
mean(expr)	列または式の計算平均を返します。
median(expr)	値のセットの中央値を返します。
min(expr)	列または式の最小値を返します。
min_by(expr1, expr2) - 2つの式の内、最小値を選択する	`expr1`の最小値に関連付けられている`expr2`の値を返します。
mode(expr [, 決定論的])	`expr`の最も頻繁な値を返します。
パーセンタイル(expr, percentage [, frequency])	グループ内の指定したパーセンタイルでの `expr` の正確なパーセンタイル値を返します。
percentile_approx(式, 割合 [, 精度])	指定したパーセンタイルでの `expr` のおおよそのパーセンタイル値を返します。
regr_slope(y, x)	グループ内の null 以外のペアの線形回帰直線の傾きを返します。
some(expr)	グループ内の`true`の少なくとも 1 つの値が`expr`場合に`true`を返します。
std(expr)	値のセットの標準偏差を返します。
stddev(expr)	値のセットの標準偏差を返します。
stddev_pop(expr)	値のセットの母集団標準偏差を返します。
stddev_samp(expr)	一連の値の標本標準偏差を返します。
string_agg(expr [, delimiter])	グループ内の null 以外の文字列値の連結を返します。
sum(expr)	列または式の値の合計を返します。
variance(expr)	値のセットの分散を返します。

算術演算

式は、次の算術演算と組み合わせることができます。

Operation	Description
expr1 % expr2	`expr1`を`expr2`で除算した剰余を返します。
乗数 * 被乗数	2 つの式の積を返します。
expr1 + expr2	`expr1`と`expr2`の合計を返します。
+ expr	式の値を返します。
expr1 - expr2	`expr2`から `expr1` を減算するときの差を返します。
-Expr	式の否定値を返します。
dividend / divisor	dividend を divisor で除算した結果を返します。
dividend div divisor	`dividend`による`divisor`の除算の整数部分を返します。
abs(expr)	数値式の絶対値を返します。
acos(expr)	`expr`の逆コサイン (アークコサイン) を返します。
asin(expr)	`expr`の逆サイン (アークサイン) を返します。
bround(expr [, d])	`expr` を使用して、小数点以下`d`桁にHALF_EVEN丸めモードで丸めた値を返します。
ceil(expr) または ceiling(expr)	`expr`より小さくない最小の整数を返します。
cos(expr)	`expr`のコサインを返します。
exp(expr)	e を`expr`乗にして返します。
floor(expr)	`expr`を超えない最大の整数を返します。
ln(expr)	式の自然対数を返します。
log(base, expr)	指定した`expr`を持つ`base`の対数を返します。
log10(expr)	式の底 10 の対数を返します。
mod(expr1, expr2)	`expr1`を`expr2`で除算した剰余を返します。
nullifzero(expr)	`NULL`が 0 の場合は`expr`を返し、それ以外の場合は`expr`を返します。
pi()	pi の値を返します。
pmod(expr1, expr2)	mod `expr1`の正の値`expr2`返します。
pow(expr1, expr2) または power(expr1, expr2)	`expr1` を `expr2` で累乗した結果を返します。
radians(expr)	度をラジアンに変換します。
rand([seed])	0 (包括) から 1 (排他的) までの範囲の均一分布を持つランダムな値を返します。
round(expr [, d]) - 指定した桁まで数値を四捨五入します。	丸めモード `expr` 使用して小数点以下 `d` 丸めHALF_UP返します。
sign(expr)	数値式の符号を返します。
sin(expr)	`expr`のサインを返します。
sqrt(expr)	`expr`の平方根を返します。
try_add(expr1, expr2)	2 つの値を追加します。エラーが発生した場合は、`NULL`を返します。
try_divide(除数,除数)	dividend を divisor で除算します。エラーが発生した場合は、`NULL`を返します。
try_multiply(乗数,多重度)	2 つの値を乗算します。エラーが発生した場合は、`NULL`を返します。
try_subtract(expr1, expr2)	`expr2`から `expr1` を減算します。エラーが発生した場合は、`NULL`を返します。
zeroifnull(expr)	`expr`が`NULL`の場合は 0 を返し、それ以外の場合は`expr`を返します。

ブール関数と演算子

カスタム計算では、基本的な比較演算子とブール演算子がサポートされます。次の演算子と関数がサポートされています。

Operation	Description
expr1 != expr2	`true`が`expr1`と等しくない場合は、`expr2`を返します。
!expr	論理ではありません。
expr1 & expr2	`expr1`と`expr2`のビットごとの AND を返します。
expr1 && expr2	`true`と`expr1`の両方が`expr2`されている場合は、`true`を返します。
expr1 <=> expr2	null 以外のオペランドの等号演算子と同じ結果を返しますが、両方が`true`の場合は`null`を返し、`false`の場合は`null`を返します。
expr1 <> expr2	`true`が`expr1`と等しくない場合は、`expr2`を返します。
expr1 < expr2	`true`が`expr1`未満の場合は、`expr2`を返します。
expr1 <= expr2	`true`が`expr1`以下の場合は、`expr2`を返します。
expr1 = expr2	`true`が`expr1`と等しい場合に`expr2`を返します。
expr1 == expr2	`true`が`expr1`と等しい場合に`expr2`を返します。
expr1 > expr2	`true`が`expr1`より大きい場合は、`expr2`を返します。
expr1 >= expr2	`true`が`expr1`以上の場合は、`expr2`を返します。
expr1 ^ expr2	`expr1`と`expr2`のビットごとの排他的 OR を返します。
expr1 \|expr2	`expr1`と`expr2`のビットごとの OR を返します。
expr1 \|\|expr2	`true`または`expr1`の少なくとも 1 つが`expr2`場合に`true`を返します。
~expr	`expr`のビットごとの NOT を返します。
expr1 と expr2	`true`と`expr1`の両方が`expr2`されている場合は、`true`を返します。
下と上の間の expr	`expr`が指定された範囲内にあるかどうかをテストします (特殊な構文)。
str ilike パターン	`true`が`str`と一致する場合に`pattern`を返します (大文字と小文字は区別されません)。 `ilike(str, pattern [, escapeChar])`として使用することもできます。
expr in (value1, value2, ...)	`expr`がリスト内の任意の値と一致するかどうかをテストします (特殊な構文)。
isnan(expr)	`true`が NaN (数値ではない) の場合は、`expr`を返します。
isnotnull(expr)	`true` が `expr` でない場合、`NULL` を返します。
isnull(expr)	`true`が`expr`されている場合は、`NULL`を返します。
文字列のようなパターン	`true`が`str`と一致する場合は、`pattern`を返します。 `like(str, pattern [, escapeChar])`として使用することもできます。
expr ではない	論理否定 (「not」プレフィックス演算子) `not(expr)`として使用することもできます。
expr1 または expr2	`true`または`expr1`の少なくとも 1 つが`expr2`場合に`true`を返します。
str regexp regexp	正規表現`truestr`一致する場合は、`regexp`を返します。
regexp_like(str, regexp)	正規表現`truestr`一致する場合は、`regexp`を返します。
str rlike regexp	正規表現`truestr`一致する場合は、`regexp`を返します。

cast 関数

指定した型に値をキャストするには、次の関数を使用します。

機能	Description
expr :: 型	`expr` の値をターゲットデータ型 `type` にキャストします。
bigint(expr)	値 `expr` を `BIGINT`にキャストします。
boolean(expr)	値 `expr` を `BOOLEAN`にキャストします。
cast(expr AS 型)	`expr` の値をターゲットデータ型 `type` にキャストします。
date(expr)	値 `expr` を `DATE`にキャストします。
decimal(expr [, p [, s]])	値`expr`を精度`DECIMAL`とスケール`p`で`s`にキャストします。
double(expr)	値 `expr` を `DOUBLE`にキャストします。
float(expr)	値 `expr` を `FLOAT`にキャストします。
int(expr)	値 `expr` を `INT`にキャストします。
string(expr)	値 `expr` を `STRING`にキャストします。
timestamp(expr)	値 `expr` を `TIMESTAMP`にキャストします。
to_date(expr [, fmt])	`expr`を持つ`fmt`を日付に変換します。
to_timestamp(expr [, fmt])	`expr`と`fmt`を組み合わせてタイムスタンプに変換します。
try_cast(expr AS 型)	`expr` の値をターゲットデータ型 `type` に安全にキャストします。
try_to_timestamp(expr [, fmt]) # expr を日時形式 (fmt) に変換しようとします。	`expr`を使用して`fmt`をタイムスタンプに安全に解析します。

日付、タイムスタンプ、および間隔の関数

日付、タイムスタンプ、および間隔を操作するには、次の関数を使用します。

機能	Description
add_months(開始日, 月数)	`num_months`後に`start_date`される日付を返します。
curdate()	現在の日付を返します。
current_date()	現在の日付を返します。
current_timestamp()	現在のタイムスタンプを返します。
current_timezone()	現在のセッションのローカルタイムゾーンを返します。
date_add(開始日, 日数)	`num_days`後に`start_date`される日付を返します。
date_diff(endDate, startDate)	`startDate`から`endDate`までの日数を返します。
date_format(expr, fmt)	タイムスタンプを `fmt`形式の文字列に変換します。
date_part(フィールド、ソース)	日付またはタイムスタンプから、年、月、日などの特定の部分を抽出します。
date_sub(start_date, num_days)	`num_days`から`start_date`前の日付を返します。
date_trunc(fmt, source)	日付またはタイムスタンプを、年や月などの指定した単位に切り捨てます。
dateadd(単位, 値, 式)	指定した時間間隔を日付またはタイムスタンプに追加します。
datediff(endDate, startDate)	`startDate`から`endDate`までの日数を返します。
day(expr)	日付またはタイムスタンプから月の日を返します。
dayname(expr)	日付またはタイムスタンプから曜日の名前を返します。
dayofmonth(expr)	日付またはタイムスタンプから月の日を返します。
dayofweek(expr)	日付またはタイムスタンプ (1 = 日曜日、7 = 土曜日) から曜日を返します。
dayofyear(expr)	日付またはタイムスタンプから年の日を返します。
extract(フィールド FROM ソース)	日付またはタイムスタンプの一部を抽出します。
from_unixtime(unix_time [, fmt])	秒数を Unix エポックからタイムスタンプに変換します。
from_utc_timestamp(timestamp, timezone)	指定されたタイムスタンプを UTC として解釈し、指定されたタイムゾーンに変換します。
getdate()	現在のタイムスタンプを返します。
hour(expr)	タイムスタンプの時間コンポーネントを返します。
last_day(expr)	日付またはタイムスタンプが属する月の最後の日を返します。
make_date(年、月、日)	年、月、日の各フィールドから日付を作成します。
make_timestamp(年、月、日、時、分、秒 [, タイムゾーン])	年、月、日、時、分、秒、および必要に応じてタイムゾーンフィールドからタイムスタンプを作成します。
minute(expr)	タイムスタンプの分部分を返します。
month(expr)	日付またはタイムスタンプの月の部分を返します。
months_between(timestamp1, timestamp2 [, roundOff]) 関数	`timestamp1`から`timestamp2`までの月数を返します。
next_day(start_date, day_of_week)	`start_date`より後の最初の日付を返し、`day_of_week`として名前を付けます。
now()	現在のタイムスタンプを返します。
quarter(expr)	日付またはタイムスタンプに基づき、年の四半期（1から4）を返します。
second(expr)	タイムスタンプの 2 番目のコンポーネントを返します。
timediff(endDate, startDate)	単位で測定された 2 つのタイムスタンプの差を返します。
timestamp_micros(マイクロ秒)	Unix エポック以降のマイクロ秒数からタイムスタンプを作成します。
timestamp_millis(ミリ秒)	Unix エポック以降のミリ秒数からタイムスタンプを作成します。
timestamp_seconds(秒)	Unix エポックからの秒数からタイムスタンプを作成します。
timestampadd(単位, 値, タイムスタンプ)	指定した時間間隔をタイムスタンプに追加します。
タイムスタンプ差分(単位, 開始, 終了)	単位で測定された 2 つのタイムスタンプの差を返します。
to_date(expr [, fmt])	`expr`を持つ`fmt`を日付に変換します。
to_timestamp(expr [, fmt])	`expr`と`fmt`を組み合わせてタイムスタンプに変換します。
to_unix_timestamp(expr [, fmt])（Unixタイムスタンプへ変換する関数）	指定された時刻の Unix タイムスタンプを返します。
to_utc_timestamp(timestamp, timezone)	指定されたタイムゾーン内の指定されたタイムスタンプを解釈し、UTC に変換します。
trunc(expr, fmt)	`expr`で書式モデル`fmt`によって指定された単位に切り捨てられた日付の時刻部分を返します。
unix_micros(timestamp)	Unix エポック以降のマイクロ秒数を返します。
unix_millis(timestamp)	Unix エポック以降のミリ秒数を返します。
unix_seconds(timestamp)	Unix エポックからの秒数を返します。
unix_timestamp([expr [, fmt]])	指定された時刻の Unix タイムスタンプを返します。
weekday(expr)	日付またはタイムスタンプ (0 = 月曜日、6 = 日曜日) から曜日を返します。
weekofyear(expr)関数	日付またはタイムスタンプから年間の週番号を返します。
year(expr)	日付またはタイムスタンプの年のコンポーネントを返します。

文字列関数

文字列を変換するには、次の関数を使用します。 datetime 文字列を変換するには、キャスト関数を参照してください。

機能	Description
base64(expr)	引数を base64 文字列に変換します。
char(expr)	指定された UTF-16 コードポイントの文字を返します。
charindex(substr, str [, pos])	`substr`の位置の後に`str`で`pos`が最初に出現する位置を返します。
concat(expr1, expr2 [, ...])	引数の連結を返します。
concat_ws(sep [, expr1 [, ...]])	`sep`で区切られた文字列の連結を返します。
contains(left, right)	`true`で`right`が見つかった場合は、`left`を返します。
convert_timezone(sourceTz, targetTz, sourceTs)	タイムスタンプ `sourceTs` を `sourceTz` タイムゾーンから `targetTz` タイムゾーンに変換します。
decode(expr, charSet)	文字セットエンコード `expr`を使用して、バイナリ `charSet`を文字列に変換します。
endswith(left, right)	`true` が `left` で終わる場合は、`right` を返します。
find_in_set(str, str_array) 関数は、指定された文字列が文字列配列の中にあるかを確認します。	コンマ区切りリスト内の指定された文字列のインデックス (1 から始まる) を返します。
format_number(expr, scale)は、数値を指定された桁数にフォーマットする関数です。	`expr`を`#,###,###.##`形式にし、小数点以下`scale`桁に丸められます。
format_string(format, expr [, ...])	printf スタイルの書式指定文字列から書式設定された文字列を返します。
hex(expr)	`expr`を 16 進数に変換します。
initcap(str)	各単語の先頭文字を大文字にした`str`を返します。
instr(str, substr)	`substr`で最初に発生した`str`の位置を返します。
lcase(str)	すべての文字が小文字に変更された `str` を返します。
left(str, len)	文字列`len`から左端の`str`文字を返します。
len(expr)	文字列またはバイナリ式の長さを返します。
length(expr)	文字列またはバイナリ式の長さを返します。
levenshtein(str1, str2 [, threshold])	指定された 2 つの文字列間の Levenshtein 距離を返します。
locate(substr, str [, pos])	`substr`の位置の後に`str`で`pos`が最初に出現する位置を返します。
lower(str)	すべての文字が小文字に変更された `str` を返します。
lpad(str, len [, pad])	`str`を`pad`で左詰めして`len`の長さにしたものを返します。
ltrim(str [, trimStr])	`str`から先頭文字を削除します。
md5(expr)	MD5 128 ビットチェックサムを 16 進文字列として返します。
parse_url(url, partToExtract [, key])	`url`からパーツを抽出します。
position(substr, str [, pos])	`substr`の位置の後に`str`で`pos`が最初に出現する位置を返します。
printf(format, expr [, ...])	printf スタイルの書式指定文字列から書式設定された文字列を返します。
regexp_count(str, regexp)	`regexp`で正規表現`str`が一致する回数を返します。
regexp_extract(str, regexp [, idx])	`regexp`に一致するグループを抽出します。
regexp_instr(str, regexp)	`regexp`内の`str`の最初の一致の位置を返します。
regexp_replace(str, regexp, rep [, position])	`str`と一致する`regexp`のすべての部分文字列を`rep`に置き換えます。
regexp_substr(str, regexp)	`regexp`内の正規表現`str`に一致する部分文字列を返します。
repeat(str, n)	`str` `n`回繰り返される文字列を返します。
replace(str, search [, replace])	`search`のすべての出現箇所を、`replace`内の`str`に置き換えます。
reverse(str)	文字の順序を逆にした `str` を返します。
right(str, len)	文字列`len`から右端の`str`文字を返します。
rtrim([trimStr,] str)	末尾の文字が削除された `str` を返します。
sha2(expr, bitLength)	ハッシュ関数の SHA-2 ファミリを返します。
split_part(str, delimiter, partNum)	`str`を`delimiter`で分割し、要求された部分を返します。
startswith(left, right)	`true`が `left` で始まる場合は、`right`を返します。
substr(str, pos [, len])	長さ`str`の`pos`から始まる`len`の部分文字列を返します。
substring(str, pos [, len])	長さ`str`の`pos`から始まる`len`の部分文字列を返します。
substring_index(str, delim, count)	`count`が出現`delim`前の部分文字列を返します。
to_char(expr [, fmt])	`expr`を文字列に変換します。
to_number(expr [, fmt])（数値化関数）	文字列 `expr` を数値に変換します。
translate(input, from, to)	`input`内の文字を`from`の対応する文字に置き換えることで、`to`を変換します。
trim(str [, trimStr])	`str`から先頭と末尾の文字を削除します。
ucase(str)	すべての文字が大文字に変更された `str` を返します。
upper(str)	すべての文字が大文字に変更された `str` を返します。
url_encode(str)	URL クエリパラメーターで使用する `str` をエンコードします。

その他の関数

次の関数もサポートされています。

機能	Description
集計する	メジャーの時間範囲またはその他の順序付けられたセット間で値を計算します。
CASE expr { WHEN opt1 THEN res1 } [...][ELSE def]終わり	一致しない場合は、`resN`または`optN`と等しい最初の`expr`の`def`を返します。
CASE { WHEN cond1 THEN res1 } [...][ELSE def]終わり	`resN` が true と評価された場合はその`condN`を返し、どれも該当しない場合は`def`を返します。
coalesce(expr1, expr2 [, ...])	最初の null 以外の引数を返します。
decode(expr, search, result [, search, result]... [, default])	`expr`を各検索値と比較し、対応する結果を返します。
get_json_object(json_txt, path)	指定した`json_txt`の`path`から JSON オブジェクトを抽出します。
greatest(expr [, ...])	すべてのパラメーターの最大値を返します。
hash(expr1 [, expr2 ...])	引数のハッシュ値を返します。
if(条件, 真の値, 偽の値)	`true_value`が`condition`場合は`true`を返し、それ以外の場合は`false_value`を返します。
iff(条件, 真の値, 偽の値)	`true_value`が`condition`場合は`true`を返し、それ以外の場合は`false_value`を返します。
ifnull(expr1, expr2)	`expr2`が`expr1`の場合は`null`を返し、それ以外の場合は`expr1`返します。
json_array_length(jsonArray)	最も外側の JSON 配列内の要素の数を返します。
least(expr [, ...])	すべてのパラメーターの最小値を返します。
monotonically_increasing_id()	単調に増加する 64 ビットの整数を返します。
nullif(expr1, expr2)	`NULL`が`expr1`と等しい場合は`expr2`を返し、それ以外の場合は`expr1`を返します。
nvl(expr1, expr2)	`expr2`が`expr1`の場合は`NULL`を返し、それ以外の場合は`expr1`返します。
nvl2(expr1, expr2, expr3)	`expr2`が`expr1`されていない場合は`NULL`を返し、それ以外の場合は`expr3`返します。
schema_of_json(json [, options])	JSON 文字列の DDL 形式でスキーマを返します。

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-10-23