JavaScript Object Notation (JSON)データの列を問い合せる場合のみ、JSONオブジェクト・アクセス式を使用できます。式は、そのデータ内の1つ以上のJSON値を含む文字列を戻します。このタイプの式の構文は、ドット表記法構文と呼ばれることがあります。
JSON_object_access_expr::=
table_alias
では、JSONデータの列を含む表の別名を指定します。この表の別名が必要であり、SQL文で表に割り当てる必要があります。
JSON_column
では、JSONデータの列の名前を指定します。列のデータ型はVARCHAR2
、CLOB
またはBLOB
である必要があり、IS
JSON
CHECK制約を列に定義する必要があります。
1つ以上のJSONオブジェクト・キーをオプションで指定できます。オブジェクト・キーによって、JSONデータの特定のJSON値を特定できます。最初のJSON_object_key
は、JSONデータのトップレベルのオブジェクト・メンバーのキー(プロパティ)名と大/小文字を区別して一致する必要があります。オブジェクト・メンバーの値が別のJSONオブジェクトである場合、オブジェクトのメンバーのキー名と一致する2番目のJSON_object_key
を指定でき、以降も同様です。これらの反復中にJSON配列が検出された場合、配列が暗黙的にアンラップされ、配列の要素がJSON_object_key
を使用して評価されます。
この式は、次のようなターゲットJSON値を含むデータ型VARCHAR2(4000)
の文字列を戻します。
単一のターゲット値の場合、文字列には、JSONスカラー値、オブジェクト、配列に関係なくその値が含まれます。
複数のターゲット値の場合、文字列には、要素がそれらの値であるJSON配列が含まれます。
JSON_object_key
を省略すると、この式は全体のJSONデータを含む文字列を戻します。この場合、文字列は、問い合せるJSONデータの列と同じデータ型です。
JSONオブジェクト・アクセス式は、4KBを超える値を返せません。値がこの制限を超えると、式はnullを返します。実際の値を取得するには、かわりにJSON_QUERY関数またはJSON_VALUE関数を使用して、RETURNING
句に適切な戻り型を指定します。
例 次の例では、「JSONドキュメントを含む表の作成: 例」で作成されるj_purchaseorder
表を使用します。この表には、po_document
と呼ばれるJSONデータの列が含まれます。これらの例では、列po_document
からJSON値を戻します。
次の文は、キー名PONumber
を使用したプロパティの値を戻します。
SELECT po.po_document.PONumber 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]
関連項目: ドット表記法構文を使用したJSONデータの問合せの詳細は、『Oracle XML DB開発者ガイド』を参照してください。 |