try_variant_insert Funktion

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

Gibt mit eingefügt bei path, oder NULL für duplizierte Objektfelder oder inkompatible Zwischentypen zurückvariantExpr.val

Syntax

try_variant_insert ( variantExpr, path, val )

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.

Returns

Ein Wert vom Typ VARIANT.

SQL-Argumente NULL geben SQL NULLzurück.

Die Funktion gibt SQL NULL für duplizierte Objektfelder oder inkompatible Zwischentypen zurück. Um stattdessen einen Fehler auszulösen, verwenden Sie variant_insert.

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

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

-- Duplicate object field
> SELECT try_variant_insert(parse_json('{"a": 1}'), '$.a', 2)
  NULL

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

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