Freigeben über


extract_json()

Gilt für: ✅Microsoft Fabric✅Azure Data ExplorerAzure MonitorMicrosoft Sentinel

Rufen Sie ein angegebenes Element aus einem JSON-Text mit einem Pfadausdruck ab.

Konvertieren Sie optional die extrahierte Zeichenfolge in einen bestimmten Typ.

Die extract_json() Funktionen sind extractjson() gleichwertig.

Syntax

extract_json(jsonPath, dataSource-Typ, )

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name Type Erforderlich Beschreibung
jsonPath string ✔️ Ein JSONPath , der einen Accessor in das JSON-Dokument definiert.
dataSource string ✔️ Ein JSON-Dokument.
type string Ein optionales Typliteral. Wenn angegeben, wird der extrahierte Wert in diesen Typ konvertiert. Wandelt beispielsweise typeof(long) den extrahierten Wert in ein long.

Leistungstipps

  • Anwenden von Where-Klauseln vor der Verwendung extract_json().
  • Erwägen Sie stattdessen den Abgleich mit einem regulären Ausdruck mit extract . Dies kann sehr viel schneller ausgeführt werden und ist effektiv, wenn die JSON aus einer Vorlage erstellt wird.
  • Verwenden Sie parse_json() , wenn Sie mehr als einen Wert aus dem JSON-Code extrahieren müssen.
  • Erwägen Sie, dass der JSON-Code bei der Aufnahme analysiert wird, indem Sie den Typ der Spalte deklarieren, die dynamisch sein soll.

Gibt zurück

Diese Funktion führt eine JSONPath-Abfrage in DataSource aus, die eine gültige JSON-Zeichenfolge enthält, optional diesen Wert abhängig vom dritten Argument in einen anderen Typ konvertiert.

Beispiel

let json = '{"name": "John", "age": 30, "city": "New York"}';
print extract_json("$.name", json, typeof(string));

Output

print_0
John