すべてのプロダクト
Search
ドキュメントセンター

Dataphin:集計関数

最終更新日:Feb 06, 2025

ADB_PG_SQL ノードでは、集計関数を使用すると、指定された文字列を柔軟に処理できます。このトピックでは、ADB_PG_SQL ノードにおける集計関数の構文、パラメーター、および使用例について詳しく説明し、開発者が文字列関数を活用できるようにします。

AnalyticDB for PostgreSQL では、次の文字列関数がサポートされています。

関数

機能

array_agg

NULL 値を含む入力値を配列に集約します。

avg

平均値を計算します。

bit_and

NULL 以外のすべての入力値に対してビット単位の AND 演算を実行します。何もない場合は空を返します。

bit_or

NULL 以外のすべての入力値に対してビット単位の OR 演算を実行します。何もない場合は空を返します。

bool_and

すべての入力値が true の場合は true を返し、それ以外の場合は false を返します。

bool_or

少なくとも 1 つの入力値が true の場合は true を返し、それ以外の場合は false を返します。

count

入力行の数をカウントします。

count

NULL 以外の式の値を持つ入力行の数をカウントします。

every

bool_and と同じです。

json_agg

NULL 値を含む値を JSON 配列に集約します。

json_object_agg

名前と値のペアを JSON オブジェクトに集約します。値は NULL にできますが、名前は NULL にできません。

max

NULL 以外のすべての入力値の中で最大の式の値を特定します。

min

NULL 以外のすべての入力値の中で最小の式の値を特定します。

string_agg

NULL 以外の入力値を区切り文字を使用して文字列に連結します。

sum

NULL 以外のすべての入力値の合計を計算します。

xmlagg

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 値を返します。