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 eingefügt oder gesetzt auf pathzurück.
Syntax
variant_set ( variantExpr, path, val [, create_if_missing] )
Argumente
-
variantExpr: EinVARIANTAusdruck. -
path: Ein Ausdruck mit einem wohlgeformten JSON-PfadausdruckSTRING. Array-Indizes sind nullbasiert. -
val: Ein Ausdruck, der auf gewirkt werdenVARIANTkann. -
create_if_missing: Ein optionaler konstanter (faltbarer)BOOLEANAusdruck. Wenntrue, entstehen fehlende Felder, Array-Elemente sowie Zwischenobjekte oder Arrays entlangpath. Der Standardwert lautettrue.
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.