variant_delete Funktion

Gilt für:Angekreuzt ja, Databricks, SQL, angekreuzt ja, 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: Ein VARIANT Ausdruck.
  • path1, path2, ...: Ein oder mehrere STRING Ausdrü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}