JSONPath の操作

JSONPath は、JSON オブジェクトの要素をクエリする標準化された方法です。JSONPath はパス式を使用して、JSON ドキュメントの要素、入れ子要素、配列に移動します。JSON の詳細については、「JSON の入門」を参照してください。

Amazon Kinesis Data Analytics はアプリケーションのソーススキーマで JSONPath 式を使用して、JSON 形式のデータがあるストリーミングソースのデータ要素を識別します。

アプリケーションの入力ストリームにストリーミングデータをマッピングする方法の詳細については、「SQL 入力列へのストリーミングソース要素のマッピング」を参照してください。

JSONPath を使用した JSON 要素へのアクセス

JSONPath 式を使用して JSON 形式のさまざまなデータにアクセスする方法について説明します。このセクションの例では、ソースストリームに次の JSON レコードが含まれていると想定します。

{
  "customerName":"John Doe",
  "address":
  {
    "streetAddress":
    [
      "number":"123",
      "street":"AnyStreet"
    ],
    "city":"Anytown"
  }
  "orders":
  [
    { "orderId":"23284", "itemName":"Widget", "itemPrice":"33.99" },
    { "orderId":"63122", "itemName":"Gadget", "itemPrice":"22.50" },
    { "orderId":"77284", "itemName":"Sprocket", "itemPrice":"12.00" }
  ]
}                
            

JSON 要素へのアクセス

JSONPath を使用して JSON データの要素をクエリするには、次の構文を使用します。ここで、$ はデータ階層のルート、elementName はクエリを実行する要素ノードの名前を表します。

$.elementName
                

次の式では、前述の JSON の例の customerName 要素をクエリします。

$.customerName

前述の式では、前述の JSON のレコードから次のように返ります。

John Doe

$.customerId

ネストされた JSON 要素へのアクセス

ネストされた JSON 要素をクエリするには、次の構文を使用します。

$.parentElement.element

次の式では、前述の JSON の例の city 要素をクエリします。

$.address.city

前述の式では、前述の JSON のレコードから次のように返ります。

Anytown

以下の構文を使用して、深いレベルのサブ要素をクエリすることができます。

$.parentElement.element.subElement

次の式では、前述の JSON の例の street 要素をクエリします。

$.address.streetAddress.street

前述の式では、前述の JSON のレコードから次のように返ります。

AnyStreet

配列へのアクセス

JSON 配列内のデータにアクセスするには、以下の方法があります。

配列内のすべての要素を単一の行として取得する

配列のコンテンツ全体を単一の行としてクエリを実行するには、次の構文を使用します。

$.arrayObject[0:]

次の式では、このセクションで使用した前述の JSON の例の orders 要素をクエリします。配列の内容は、単一行の 1 つの列で返ります。

$.orders[0:]

前述の式は、このセクションで使用した JSON レコード例から次を返します。

[{"orderId":"23284","itemName":"Widget","itemPrice":"33.99"},{"orderId":"61322","itemName":"Gadget","itemPrice":"22.50"},{"orderId":"77284","itemName":"Sprocket","itemPrice":"12.00"}]

配列内のすべての要素を別々の行として取得する

配列内の各要素を別々の行としてクエリを実行するには、次の構文を使用します。

$.arrayObject[0:].element

次の式では、前述の JSON の例の orderId 要素をクエリし、配列内の各要素は別々の行で返ります。

$.orders[0:].orderId

前述の例では、前述の JSON レコードから以下のように返ります。その際、各データ項目は別々の行で返ります。

その他の考慮事項

JSONPath を操作するには、他にも次のような考慮事項があります。

関連トピック