Partager via


extract_json()

S’applique à : ✅Microsoft Fabric✅Azure Data ExplorerAzure MonitorMicrosoft 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() les extract_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