Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gilt für:
, Databricks, SQL,
, 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: EinVARIANTAusdruck. -
path: Ein Ausdruck mit einem wohlgeformten JSON-PfadausdruckSTRING. Array-Indizes sind nullbasiert. -
val: Ein Ausdruck, der auf gewirkt werdenVARIANTkann.
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.