Udostępnij za pośrednictwem


extract_json()

Dotyczy: ✅Microsoft Fabric✅Azure Data ExplorerAzure MonitorMicrosoft Sentinel

Pobierz określony element z tekstu JSON przy użyciu wyrażenia path.

Opcjonalnie przekonwertuj wyodrębniony ciąg na określony typ.

Funkcje extract_json() i extractjson() są równoważne

Składnia

extract_json(Typ źródła danych, jsonPath, )

Dowiedz się więcej na temat konwencji składni.

Parametry

Nazwisko Type Wymagania opis
jsonPath string ✔️ Ścieżka JSON, która definiuje metodę dostępu do dokumentu JSON.
dataSource string ✔️ Dokument JSON.
type string Opcjonalny literał typu. Jeśli zostanie podana, wyodrębniona wartość zostanie przekonwertowana na ten typ. Na przykład typeof(long) spowoduje przekonwertowanie wyodrębnionej wartości na longwartość .

Wskazówki dotyczące wydajności

  • Zastosuj klauzule where przed użyciem polecenia extract_json().
  • Rozważ użycie dopasowania wyrażenia regularnego do wyodrębnienia . Może to działać znacznie szybciej i jest skuteczne, jeśli kod JSON jest generowany na podstawie szablonu.
  • Użyj parse_json() polecenia , jeśli musisz wyodrębnić więcej niż jedną wartość z pliku JSON.
  • Rozważ przeanalizowanie kodu JSON podczas pozyskiwania, deklarując typ kolumny jako dynamiczny.

Zwraca

Ta funkcja wykonuje zapytanie JSONPath do źródła danych, który zawiera prawidłowy ciąg JSON, opcjonalnie konwertując tę wartość na inny typ w zależności od trzeciego argumentu.

Przykład

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

Wyjście

print_0
Michał