Partager via


extract_json()

S’applique à : ✅Microsoft Fabric

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() les extractjson() 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