extract_json()
S’applique à : ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
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
extractjson()
lesextract_json()
fonctions sont équivalentes
Syntaxe
extract_json(
type jsonPath,
dataSource,
)
En savoir plus sur les conventions de syntaxe.
Paramètres
Nom | Type | Requise | Description |
---|---|---|---|
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.
Exemple
let json = '{"name": "John", "age": 30, "city": "New York"}';
print extract_json("$.name", json, typeof(string));
Sortie
print_0 |
---|
John |