Utilisation de JSONPath

JSONPath est une méthode normalisée d'interrogation des éléments d'un objet JSON. JSONPath utilise des expressions de chemin pour parcourir les éléments, les éléments imbriqués et les tableaux d'un document JSON. Pour de plus amples informations sur JSON, veuillez consulter Introducing JSON.

Amazon Kinesis Data Analytics utilise des expressions JSONPath dans le schéma source de l’application pour identifier les éléments de données dans une source de streaming qui contient des données au format JSON.

Pour plus d'informations sur la façon de mapper les données en streaming sur le flux d'entrée de l'application, consultez Mappage d'éléments d'une source de streaming à des colonnes d'entrée SQL.

Accès à des éléments JSON avec JSONPath

Vous découvrirez ci-dessous comment utiliser des expressions JSONPath pour accéder à divers éléments de données au format JSON. Pour les exemples de cette section, supposons que le flux source contient l’enregistrement JSON suivant :

{
  "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" }
  ]
}                
            

Accès à des éléments JSON

Pour interroger un élément dans des données JSON à l'aide de JSONPath, utilisez la syntaxe suivante. Ici, $ représente la racine de la hiérarchie des données et elementName est le nom du nœud de l'élément à interroger.

$.elementName
                

L'expression suivante interroge l'élément customerName de l'exemple JSON précédent.

$.customerName

L'expression précédente retourne les informations suivantes à partir de l'enregistrement JSON précédent.

John Doe

$.customerId

Accès aux éléments JSON imbriqués

Pour interroger un élément JSON imbriqué, utilisez la syntaxe suivante.

$.parentElement.element

L'expression suivante interroge l'élément city de l'exemple JSON précédent.

$.address.city

L'expression précédente retourne les informations suivantes à partir de l'enregistrement JSON précédent.

Anytown

Vous pouvez interroger d'autres niveaux de sous-éléments à l'aide de la syntaxe suivante.

$.parentElement.element.subElement

L'expression suivante interroge l'élément street de l'exemple JSON précédent.

$.address.streetAddress.street

L'expression précédente retourne les informations suivantes à partir de l'enregistrement JSON précédent.

AnyStreet

Accès aux tableaux

Vous pouvez accéder aux données dans un tableau JSON de la manière suivante :

Récupérer tous les éléments du tableau dans une ligne unique.

Pour interroger tout le contenu d'un tableau sur une seule ligne, utilisez la syntaxe suivante.

$.arrayObject[0:]

L'expression suivante interroge tout le contenu de l'élément orders de l'exemple JSON précédent utilisé dans cette section. Elle retourne le contenu du tableau dans une seule colonne et sur une seule ligne.

$.orders[0:]

L'expression précédente retourne les éléments suivants de l'exemple JSON utilisé dans cette section.

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

Récupérez tous les éléments dans un tableau dans des lignes séparées

Pour interroger chaque élément d'un tableau sur une ligne distincte, utilisez la syntaxe suivante.

$.arrayObject[0:].element

L'expression suivante interroge les éléments orderId de l'exemple JSON précédent et retourne chaque élément du tableau sur une ligne distincte.

$.orders[0:].orderId

L'expression précédente retourne les informations suivantes à partir de l'enregistrement JSON précédent, chaque élément de données étant retourné sur une ligne distincte.

Autres considérations

Voici quelques considérations supplémentaires concernant l'utilisation de JSONPath :

Rubriques connexes