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 die Felder oder Arrayelemente an den angegebenen Pfaden entfernt zurück variantExpr .
Syntax
variant_delete ( variantExpr, path1 [, path2, ...] )
Argumente
-
variantExpr: EinVARIANTAusdruck. -
path1,path2, ...: Ein oder mehrereSTRINGAusdrücke mit wohlgeformten JSON-Pfadausdrücken, die die zu entfernenden Pfade angeben. Array-Indizes sind nullbasiert.
Returns
Ein Wert vom Typ VARIANT.
Pfade werden von links nach rechts auf das Ergebnis jeder vorangegangenen Löschung angewendet. Das Löschen eines Arrayelements verschiebt nachfolgende Elemente nach links.
Fehlende Felder, Out-of-Range-Indizes und inkompatible Zwischentypen werden ignoriert. Leere Objekte und Arrays werden erhalten.
Wenn variantExpr SQL NULList, ergibt sich SQL NULL. SQL-Pfade NULL werden übersprungen.
Fehlgeformte Pfade oder der Wurzelpfad $ erheben INVALID_VARIANT_PATH.
Häufige Fehlerbedingungen
Examples
-- Remove object fields
> SELECT variant_delete(parse_json('{"a": 1, "b": 2, "c": 3}'), '$.a', '$.c')
{"b":2}
-- Remove an array element
> SELECT variant_delete(parse_json('[1, 2, 3]'), '$[1]')
[1,3]
-- Apply paths from left to right
> SELECT variant_delete(parse_json('[1, 2, 3]'), '$[0]', '$[0]')
[3]
-- Missing and incompatible paths
> SELECT variant_delete(parse_json('{"a": 1}'), '$.missing', '$.a.b')
{"a":1}
-- Preserve an empty object
> SELECT variant_delete(parse_json('{"a": {"b": 1}}'), '$.a.b')
{"a":{}}
-- Skip a SQL NULL path
> SELECT variant_delete(parse_json('{"a": 1, "b": 2}'), '$.a', CAST(NULL AS STRING))
{"b":2}