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