Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gilt für:
, Databricks, SQL,
, 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: EinVARIANTAusdruck. -
path1,path2, ...: Ein oder mehrereSTRINGAusdrü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}