JSONオブジェクト・アクセス式

JSONオブジェクト・アクセス式は、JSONデータの列を問い合せる場合にのみ使用されます。そのデータ内の1つ以上のJSON値を含む文字列を戻します。このタイプの式の構文は、ドット表記法構文といいます。

JSON_object_access_expr::=

図json_object_access_expr.epsの説明

array_step::=

図array_step.epsの説明

table_aliasでは、JSONデータの列を含む表の別名を指定します。この表の別名が必要であり、SQL文で表に割り当てる必要があります。
JSON_columnでは、JSONデータの列の名前を指定します。列のデータ型はVARCHAR2、CLOB、BLOBまたはJSONである必要があります。

列がJSON生成ファンクション(JSON_QUERYまたはTREAT)の結果である場合、その列にはJSONデータ型のデータを格納できます。

JSON型以外のデータ型を識別する場合、列にIS JSONチェック制約を定義できます。
1つ以上のJSONオブジェクト・キーをオプションで指定できます。オブジェクト・キーによって、JSONデータの特定のJSON値を特定できます。最初のJSON_object_keyは、JSONデータのトップレベルのオブジェクト・メンバーのキー(プロパティ)名と大/小文字を区別して一致する必要があります。オブジェクト・メンバーの値が別のJSONオブジェクトである場合、オブジェクトのメンバーのキー名と一致する2番目のJSON_object_keyを指定でき、以降も同様です。これらの反復中にJSON配列が検出され、array_stepを指定しない場合、配列が暗黙的にアンラップされ、配列の要素がJSON_object_keyを使用して評価されます。
JSON値が配列の場合、オプションで1つ以上のarray_step句を指定できます。これにより、JSON配列の特定の要素にアクセスできます。
- integerを使用して、JSON配列の索引integerの要素を指定します。integer TO integerを使用して、2つのinteger索引値の間(これらの値を含む)の要素の範囲を指定します。指定された要素が評価されるJSON配列にある場合、配列ステップはそれらの要素と一致する結果になります。それ以外の場合、一致しない配列ステップになります。JSON配列の最初の要素は索引0です。
- ワイルド・カード記号であるアスタリスク(*)を使用して、JSON配列のすべての要素を指定します。評価されるJSON配列に少なくとも1つの要素が含まれる場合、JSON配列のすべての要素が一致する配列ステップになります。それ以外の場合、一致しない配列ステップになります。

JSONオブジェクト・アクセス式は、次のようなターゲットJSON値を含むデータ型VARCHAR2(4000)の文字列を戻します。

単一のターゲット値の場合、文字列には、JSONスカラー値、オブジェクト、配列に関係なくその値が含まれます。
複数のターゲット値の場合、文字列には、要素がそれらの値であるJSON配列が含まれます。

JSON_object_keyを省略すると、この式は全体のJSONデータを含む文字列を戻します。この場合、文字列は、問い合せるJSONデータの列と同じデータ型です。

JSONオブジェクト・アクセス式は、4KBを超える値を返せません。値がこの制限を超えると、式はnullを返します。実際の値を取得するには、かわりにJSON_QUERY関数またはJSON_VALUE関数を使用して、RETURNING句に適切な戻り型を指定します。

JSONオブジェクト・アクセス式の照合導出ルールは、JSON_QUERYファンクションのものと同じです。

関連項目:

JSON_QUERYファンクションの照合導出ルールは、『Oracle Databaseグローバリゼーション・サポート・ガイド』の付録Cを参照してください。

例

次の例では、JSONドキュメントを含む表の作成: 例で作成されるj_purchaseorder表を使用します。この表には、po_documentと呼ばれるJSONデータの列が含まれます。これらの例では、列po_documentからJSON値を戻します。

次の文は、PONumberというキー名のプロパティの値を返します。戻り値の1600はSQLの番号です。

SELECT po.po_document.PONumber.number()
  FROM j_purchaseorder po;

PONumber
--------
1600

次の文は、値がJSONオブジェクトであるキー名ShippingInstructionsを使用したプロパティを最初に対象とします。この文は、そのオブジェクト内のキー名Phoneを使用したプロパティを対象とします。この文は、JSON配列であるPhoneの値を戻します。

SELECT po.po_document.ShippingInstructions.Phone
  FROM j_purchaseorder po;
 
SHIPPINGINSTRUCTIONS
-------------------------------------------------------------------------------------
[{"type":"Office","number":"909-555-7307"},{"type":"Mobile","number":"415-555-1234"}]

次の文は、値がJSON配列であるキー名LineItemsを使用したプロパティを最初に対象とします。この式は配列を暗黙的にアンラップし、JSONオブジェクトである要素を評価します。次に、この文は、アンラップされたオブジェクト内のキー名Partを使用したプロパティを対象とし、2つのオブジェクトを確認します。この文は、それらのオブジェクト内のキー名Descriptionを使用したプロパティを対象とし、文字列値を確認します。複数の値が戻されるため、値はJSON配列の要素として戻されます。

SELECT po.po_document.LineItems.Part.Description
  FROM j_purchaseorder po;
 
LINEITEMS
-----------------------------------
[One Magic Christmas,Lethal Weapon]