JSON_ARRAYAGG

構文

図json_arrayagg.epsの説明

(この句の構文の詳細は、このドキュメントの「SELECT」の「order_by_clause::=」を参照)

JSON_on_null_clause::=

図json_on_null_clause.epsの説明

JSON_returning_clause::=

図json_returning_clause.epsの説明

目的

SQL/JSONファンクションJSON_ARRAYAGGは集計ファンクションです。これは、その入力として、SQL式の列を取得し、各式をJSON値に変換して、これらのJSON値を含む単一のJSON配列を戻します。

expr

exprでは、JSONオブジェクト、JSON配列、数値リテラル、テキスト・リテラルまたはNULLと評価される任意のSQL式を指定できます。このファンクションは、数値リテラルをJSON数値に、テキスト・リテラルをJSON文字値に変換します。

FORMAT JSON

このオプション句を使用すると、入力文字列がJSONであることを示すため、出力で引用符に囲まれません。

order_by_clause

この句により、文で戻されるJSON配列内のJSON値を順序付けることができます。この句のセマンティクスの詳細は、このドキュメントの「SELECT」の「order_by_clause」を参照してください。

JSON_on_null_clause

この句を使用して、exprがNULLと評価される場合のこのファンクションの動作を指定します。

NULL ON NULL - この句を指定した場合は、JSONのNULL値が戻されます。
ABSENT ON NULL - この句を指定した場合は、JSON配列からこの値が省略されます。これはデフォルトです。

JSON_returning_clause

この句を使用して、このファンクションで戻される文字列のデータ型を指定します。次のデータ型を指定できます。

VARCHAR2[(size [BYTE,CHAR])]

SQLでVARCHAR2データ型を指定する場合、サイズを指定する必要があります。ただし、この句はサイズを省略できます。
シングルバイト文字またはマルチバイト文字を含むキャラクタ・ラージ・オブジェクトを戻すCLOB。
AL32UTF8文字セットのバイナリ・ラージ・オブジェクトを戻すBLOB。
JSONデータを戻すJSON。

JSON型を使用するには、データベース初期化パラメータcompatibleを20以上に設定する必要があります。

この句を省略するか、VARCHAR2を指定してsize値を省略した場合、JSON_ARRAYAGGはVARCHAR2(4000)型の文字列を戻します。

前述のデータ型の詳細は、「データ型」を参照してください。

STRICT

STRICT句を指定して、JSON生成ファンクションの出力が正しいJSONであることを確認します。チェックに失敗すると、構文エラーが発生します。

例については、JSON_OBJECTを参照してください。

WITH UNIQUE KEYS

WITH UNIQUE KEYSを指定すると、生成されたJSONオブジェクトが一意キーを持つことが保証されます。

例

次の文では、ID番号を含む表id_tableを作成します。

CREATE TABLE id_table (id NUMBER);
INSERT INTO id_table VALUES(624);
INSERT INTO id_table VALUES(null);
INSERT INTO id_table VALUES(925);
INSERT INTO id_table VALUES(585);

次の例では、表id_tableのID番号からJSON配列を構成します。

SELECT JSON_ARRAYAGG(id ORDER BY id RETURNING VARCHAR2(100)) ID_NUMBERS
  FROM id_table;

ID_NUMBERS
-------------
[585,624,925]