ADB_PG_SQL ノードでは、集計関数を使用すると、指定された文字列を柔軟に処理できます。このトピックでは、ADB_PG_SQL ノードにおける集計関数の構文、パラメーター、および使用例について詳しく説明し、開発者が文字列関数を活用できるようにします。
AnalyticDB for PostgreSQL では、次の文字列関数がサポートされています。
関数 | 機能 |
NULL 値を含む入力値を配列に集約します。 | |
平均値を計算します。 | |
NULL 以外のすべての入力値に対してビット単位の AND 演算を実行します。何もない場合は空を返します。 | |
NULL 以外のすべての入力値に対してビット単位の OR 演算を実行します。何もない場合は空を返します。 | |
すべての入力値が true の場合は true を返し、それ以外の場合は false を返します。 | |
少なくとも 1 つの入力値が true の場合は true を返し、それ以外の場合は false を返します。 | |
入力行の数をカウントします。 | |
NULL 以外の式の値を持つ入力行の数をカウントします。 | |
bool_and と同じです。 | |
NULL 値を含む値を JSON 配列に集約します。 | |
名前と値のペアを JSON オブジェクトに集約します。値は NULL にできますが、名前は NULL にできません。 | |
NULL 以外のすべての入力値の中で最大の式の値を特定します。 | |
NULL 以外のすべての入力値の中で最小の式の値を特定します。 | |
NULL 以外の入力値を区切り文字を使用して文字列に連結します。 | |
NULL 以外のすべての入力値の合計を計算します。 | |
NULL 以外の XML 値を 1 つの XML 値にマージします。 |
array_agg
コマンド構文
array_agg(expression)コマンドの説明: NULL 値を含む入力値を配列に集約します。
パラメーターの説明:
expression: 必須。列名または式。
戻り値の説明: 式または列の指定されたグループからの NULL 値を含むすべての値を含む配列を返します。
avg
コマンド構文
avg(value)コマンドの説明: 平均値を計算します。
パラメーターの説明:
value: 必須。平均計算の列名または式。
戻り値の説明: グループ内の指定されたすべての値の平均を返します。
bit_and
コマンド構文
bit_and(expression)コマンドの説明: NULL 以外のすべての入力値に対してビット単位の AND 演算を実行します。何もない場合は空を返します。
パラメーターの説明:
expression: 必須。整数型またはビット型の値を受け入れる列名または式。
戻り値の説明: NULL 以外のすべての入力値に対するビット単位の AND 演算の結果である、入力と同じ型の値を返します。
bit_or
コマンド構文
bit_or(expression)コマンドの説明: NULL 以外のすべての入力値に対してビット単位の OR 演算を実行します。何もない場合は空を返します。
パラメーターの説明:
expression: 必須。列名または式。
戻り値の説明: NULL 以外のすべての入力値に対するビット単位の OR 演算の結果である、入力と同じ型の値を返します。
bool_and
コマンド構文
bool_and(expression)コマンドの説明: すべての入力値が true の場合は true を返し、それ以外の場合は false を返します。
パラメーターの説明:
expression: 必須。列名または式。
戻り値の説明: NULL 以外のすべての入力値が true の場合は true を返し、それ以外の場合は false を返します。
bool_or
コマンド構文
bool_or(expression)コマンドの説明: 少なくとも 1 つの入力値が true の場合は true を返し、それ以外の場合は false を返します。
パラメーターの説明:
expression: 必須。列名または式。
戻り値の説明: NULL 以外の入力値が true の場合は true を返し、それ以外の場合は false を返します。
count
コマンド構文
count(*)コマンドの説明: 入力行の数をカウントします。
戻り値の説明: グループ内のすべての行の数を返します。
count
コマンド構文
count(expression)コマンドの説明: NULL 以外の式の値を持つ入力行の数をカウントします。
パラメーターの説明:
expression: 必須。カウントする列名または式。
戻り値の説明: グループ内の NULL 以外の値の数を返します。
every
コマンド構文
every(expression)コマンドの説明: bool_and と同じです。
パラメーターの説明:
expression: 必須。列名または式。
戻り値の説明: NULL 以外のすべての入力値が true の場合は true を返し、それ以外の場合は false を返します。
json_agg
コマンド構文
json_agg(expression)コマンドの説明: NULL 値を含む値を JSON 配列に集約します。
パラメーターの説明:
expression: 必須。列名または式。
戻り値の説明: 式または列の指定されたグループからの NULL 値を含むすべての値を含む JSON 配列を返します。
json_object_agg
コマンド構文
json_object_agg(name, value)コマンドの説明: 名前と値のペアを JSON オブジェクトに集約します。値は NULL にできますが、名前は NULL にできません。
パラメーターの説明:
name: 必須。JSON オブジェクトのキー生成用の列名または式。
value: 必須。JSON オブジェクトの値生成用の列名または式。
戻り値の説明: グループ内の指定された列または式からのキーと値のペアを含む JSON オブジェクトを返します。
max
コマンド構文
max(expression)コマンドの説明: NULL 以外のすべての入力値の中で最大の式の値を特定します。
パラメーターの説明:
expression: 必須。最大値計算の列名または式。
戻り値の説明: グループ内の指定されたすべての値の最大値を返します。
min
コマンド構文
min(expression)コマンドの説明: NULL 以外のすべての入力値の中で最小の式の値を特定します。
パラメーターの説明:
expression: 必須。最小値計算の列名または式。
戻り値の説明: グループ内の指定されたすべての値の最小値を返します。
string_agg
コマンド構文
string_agg(expression, delimiter)コマンドの説明: このコマンドは、null以外の入力値を指定されたデリミタを使用して単一の文字列に連結します。さらに、
order byを使用してソート順を定義できます。詳細については、「4.2.7. 集約式」をご参照ください。パラメーターの説明:
expression: 必須。列名または式。
戻り値の説明: 指定された順序で連結された NULL 以外のすべての入力値で構成される文字列を返します。
sum
コマンド構文
sum(expression)コマンドの説明: NULL 以外のすべての入力値の合計を計算します。
パラメーターの説明:
expression: 必須。合計計算の列名または式。
戻り値の説明: グループ内の指定されたすべての値の合計を返します。
xmlagg
コマンド構文
xmlagg(expression)コマンドの説明: NULL 以外の XML 値を 1 つの XML 値にマージします。
パラメーターの説明:
expression: 必須。NULL 以外の XML 値。
戻り値の説明: 連結された XML 値を返します。