variant_pick Funktion

Gilt für:Angekreuzt ja, Databricks, SQL, angekreuzt ja, Databricks, Laufzeit 19 und höher.

Gibt ein zurück VARIANT , das nur die Felder und Array-Elemente enthält, die von den angegebenen Pfaden ausgewählt wurden variantExpr .

Syntax

variant_pick ( variantExpr, path1 [, path2, ...] )

Argumente

  • variantExpr: Ein VARIANT Ausdruck.
  • path1, path2, ...: Ein oder mehrere STRING Ausdrücke mit wohlgeformten JSON-Pfadausdrücken, die die zu behaltenden Pfade angeben. Array-Indizes sind nullbasiert.

Returns

Ein Wert vom Typ VARIANT.

Ausgewählte Felder und Elemente behalten ihre übergeordnete Struktur. Arrays enthalten nur ausgewählte Elemente in ihrer ursprünglichen Reihenfolge.

Pfadreihenfolge und Duplikate beeinflussen das Ergebnis nicht. Die Auswahl eines Elternteils umfasst alle seine Kinder. Der Root-Pfad $ wählt den gesamten Wert aus.

Fehlende Felder, Out-of-Range-Indizes und inkompatible Zwischentypen werden ignoriert. Ohne Übereinstimmungen geben {} Objekt- und Array-Eingaben jeweils und zurück []. Skalare und Variant-Nullwerte bleiben unverändert.

Wenn variantExpr SQL NULList, ergibt sich SQL NULL. SQL-Pfade NULL werden übersprungen.

Fehlgeformte Pfade heben INVALID_VARIANT_PATH.

Häufige Fehlerbedingungen

Examples

-- Select object fields
> SELECT variant_pick(parse_json('{"a": 1, "b": 2, "c": 3}'), '$.a', '$.c')
  {"a":1,"c":3}

-- Select a nested field
> SELECT variant_pick(parse_json('{"a": {"b": 1, "c": 2}, "d": 3}'), '$.a.b')
  {"a":{"b":1}}

-- Preserve array order and ignore duplicate paths
> SELECT variant_pick(parse_json('[10, 20, 30, 40]'), '$[2]', '$[0]', '$[2]')
  [10,30]

-- Overlapping paths
> SELECT variant_pick(parse_json('{"a": {"b": 1, "c": 2}}'), '$.a.b', '$.a')
  {"a":{"b":1,"c":2}}

-- Missing path
> SELECT variant_pick(parse_json('{"a": {"b": 1}}'), '$.a.missing')
  {}

-- Skip a SQL NULL path
> SELECT variant_pick(parse_json('{"a": 1, "b": 2}'), '$.a', CAST(NULL AS STRING))
  {"a":1}