Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Obtient un élément spécifié à partir d’un texte JSON à l’aide d’une expression de chemin.
Convertit éventuellement la chaîne extraite un type spécifique.
Les fonctions et
extract_json()lesextractjson()fonctions sont équivalentes
Syntaxe
extract_json(
type jsonPath,dataSource,)
En savoir plus sur les conventions de syntaxe.
Paramètres
| Nom | Catégorie | Requise | Descriptif |
|---|---|---|---|
| jsonPath | string |
✔️ | JSONPath qui définit un accesseur dans le document JSON. |
| dataSource | string |
✔️ | Document JSON. |
| type | string |
Littéral de type facultatif. Si elle est fournie, la valeur extraite est convertie en ce type. Par exemple, typeof(long) convertit la valeur extraite en un long. |
Astuces pour les performances
- Appliquez les clauses where avant d’utiliser
extract_json(). - Utilisez plutôt une correspondance d’expression régulière avec extract . L’exécution peut être beaucoup plus rapide, et elle est efficace si le JSON est généré à partir d’un modèle.
- Utilisez
parse_json()si vous devez extraire plusieurs valeurs de JSON. - Envisagez d’analyser le json lors de l’ingestion en déclarant le type de la colonne à dynamique.
Retours
Cette fonction effectue une requête JSONPath dans dataSource, qui contient une chaîne JSON valide, en convertissant éventuellement cette valeur en un autre type en fonction du troisième argument.
Exemples
L’exemple suivant extrait le nom d’une chaîne JSON et retourne une table portant le nom.
let json = '{"name": "John", "age": 30, "city": "New York"}';
print extract_json("$.name", json, typeof(string));
Sortie
| print_0 |
|---|
| John |