variant_insert Funktion

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

Gibt variantExpr mit val als Feld oder Array-Element eingefügt bei zurück path.

Syntax

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.

Das Einfügen des Arrays verschiebt nachfolgende Elemente nach rechts. Ein Index, der der Arraylänge entspricht, fügt val. hinzu. Ein größerer Index füllt das Array vor dem Einfügen mit varianten Nullwerten.

Fehlende Zwischenobjekte oder Arrays werden entsprechend dem nächsten Pfadsegment erstellt.

SQL-Argumente NULL geben SQL NULLzurück.

Doppelte Objektfelder werden VARIANT_DUPLICATE_KEY. Inkompatible Zwischentypen erhöhen VARIANT_PATH_TYPE_MISMATCH. Um stattdessen SQL NULL zurückzugeben, verwenden Sie try_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 variant_insert(parse_json('{"a": 1}'), '$.b', 2)
  {"a":1,"b":2}

-- Create a missing path
> SELECT variant_insert(parse_json('{}'), '$.a[0]', 1)
  {"a":[1]}

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

-- Pad an array with variant nulls
> SELECT variant_insert(parse_json('["a", "b"]'), '$[5]', 'z')
  ["a","b",null,null,null,"z"]

-- Insert a variant null
> SELECT variant_insert(parse_json('{"a": 1}'), '$.b', parse_json('null'))
  {"a":1,"b":null}

-- SQL NULL argument
> SELECT variant_insert(parse_json('{"a": 1}'), '$.b', CAST(NULL AS VARIANT))
  NULL

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