try_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, oder NULL für inkompatible Zwischentypen.

Syntax

try_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.

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

SQL-Argumente NULL geben SQL NULLzurück.

Die Funktion gibt SQL NULL für inkompatible Zwischentypen zurück. Um stattdessen einen Fehler auszulösen, verwenden Sie 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 try_variant_set(parse_json('{"a": 1}'), '$.a', 99)
  {"a":99}

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

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

-- Invalid root path
> SELECT try_variant_set(parse_json('{}'), '$', 1)
  Error: INVALID_VARIANT_PATH.