variant_set Funktion

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

Gibt variantExpr mit val eingefügt oder gesetzt auf pathzurück.

Syntax

variant_set ( variantExpr, path, val [, create_if_missing] )

Argumente

  • variantExpr: Ein VARIANT Ausdruck.
  • path: Ein Ausdruck mit einem wohlgeformten JSON-PfadausdruckSTRING. Array-Indizes sind nullbasiert.
  • val: Ein Ausdruck, der auf gewirkt werden VARIANTkann.
  • create_if_missing: Ein optionaler konstanter (faltbarer) BOOLEAN Ausdruck. Wenn true, entstehen fehlende Felder, Array-Elemente sowie Zwischenobjekte oder Arrays entlang path. Der Standardwert lautet true.

Returns

Ein Wert vom Typ VARIANT.

Das Ersetzen eines Arrayelements verschiebt keine anderen Elemente.

Wenn create_if_missing , truewerden fehlende Felder und Zwischencontainer erstellt. Ein Index, der der Arraylänge entspricht, fügt val. hinzu. Ein größerer Index füllt das Array mit varianten Nullwerten, bevor er hinzugefügt valwird.

Wenn create_if_missing ist false, bleibt variantExpr ein fehlender Ziel- oder Zwischenpfad unverändert.

SQL-Argumente NULL geben SQL NULLzurück.

Inkompatible Zwischentypen erheben VARIANT_PATH_TYPE_MISMATCH, unabhängig von create_if_missing. Um stattdessen SQL NULL zurückzugeben, verwenden Sie try_variant_set.

Fehlgeformte Pfade oder der Wurzelpfad $ lösen INVALID_VARIANT_PATH, und Ergebnisse, die das Variantengrößenlimit überschreiten, lösen VARIANT_SIZE_LIMIT.

Häufige Fehlerbedingungen

Examples

-- Replace an object field
> SELECT variant_set(parse_json('{"a": 1}'), '$.a', 2)
  {"a":2}

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

-- Replace an array element
> SELECT variant_set(parse_json('["a", "b", "c"]'), '$[1]', 'z')
  ["a","z","c"]

-- Append at the array length
> SELECT variant_set(parse_json('["a", "b", "c"]'), '$[3]', 'z')
  ["a","b","c","z"]

-- Missing path with creation disabled
> SELECT variant_set(parse_json('{"a": 1}'), '$.b', 2, false)
  {"a":1}

-- Incompatible path
> SELECT variant_set(parse_json('{"a": 1}'), '$.a.b', 2)
  Error: VARIANT_PATH_TYPE_MISMATCH.