JSON_OBJECT

構文

図json_object.epsの説明

JSON_on_null_clause::=

図json_on_null_clause.epsの説明

JSON_returning_clause::=

図json_returning_clause.epsの説明

目的

SQL/JSONファンクションJSON_OBJECTでは、その入力として、1つ以上のプロパティのキーと値のペアを取得します。これは、それらのキーと値のペアごとのオブジェクト・メンバーを含むJSONオブジェクトを戻します。

[KEY] string VALUE expr

この句を使用して、プロパティのキーと値のペアを指定します。

KEYはオプションで、セマンティクスを明確にするために使用されます。
stringを使用して、大/小文字を区別するテキスト・リテラルとしてプロパティ・キー名を指定します。
exprを使用して、プロパティ値を指定します。exprでは、SQL数値リテラルまたはテキスト・リテラルと評価される任意の式を指定できます。exprが数値リテラルと評価される場合は結果のプロパティ値がJSON数値になり、そうでない場合は結果のプロパティ値が二重引用符で囲まれた大/小文字を区別するJSON文字列値になります。

FORMAT JSON

入力式の後にFORMAT JSONを指定すると、結果の値がJSONデータを表し、出力で引用符で囲まれないことを宣言できます

JSON_on_null_clause

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

NULL ON NULL - この句を指定した場合は、JSONのNULL値が戻されます。これはデフォルトです。
ABSENT ON NULL - この句を指定した場合は、JSONオブジェクトからプロパティのキーと値のペアが省略されます。

JSON_returning_clause

このファンクションによって戻される文字列のデータ型はVARCHAR2になります。この句により、VARCHAR2データ型のサイズを指定できます。サイズをバイト数として指定する場合はBYTE、サイズを文字数として指定する場合はCHARを使用します。デフォルトはBYTEです。この句を省略するか、この句を指定してsize値を省略した場合、JSON_OBJECTはVARCHAR2(4000)型の文字列を戻します。

詳細は、「VARCHAR2データ型」を参照してください。SQLでVARCHAR2データ型を指定する場合、サイズを指定する必要があります。ただし、JSON_returning_clauseではサイズを省略できます。

例

次の例では、それぞれが2つのキーと値のペアを含むJSONオブジェクトを戻します。

SELECT JSON_OBJECT (
    KEY 'deptno' IS d.department_id,
    KEY 'deptname' IS d.department_name 
    ) "Department Objects"
  FROM departments d
  ORDER BY d.department_id;

Department Objects
----------------------------------------
{"deptno":10,"deptname":"Administration"}
{"deptno":20,"deptname":"Marketing"}
{"deptno":30,"deptname":"Purchasing"}
{"deptno":40,"deptname":"Human Resources"}
{"deptno":50,"deptname":"Shipping"}
. . .