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 angehängtem Array bei path, oder NULL wenn ein Zwischenwert einen inkompatiblen Typ hat oder das Ziel kein Array ist.
Syntax
try_variant_array_append ( variantExpr, path, val )
Argumente
-
variantExpr: EinVARIANTAusdruck. -
path: Ein Ausdruck mit einem wohlgeformten JSON-Pfadausdruck, derSTRINGdas Ziel-Array angibt. Array-Indizes sind nullbasiert. -
val: Ein Ausdruck, der auf gewirkt werdenVARIANTkann.
Returns
Ein Wert vom Typ VARIANT.
Ein fehlender Weg bleibt variantExpr unverändert.
SQL-Argumente NULL geben SQL NULLzurück.
Die Funktion gibt SQL NULL für inkompatible Zwischentypen oder ein Nicht-Array-Ziel zurück. Um stattdessen einen Fehler auszulösen, verwenden Sie variant_array_append.
Fehlgeformte Pfade erhöhen INVALID_VARIANT_PATH, und Ergebnisse, die das Variantengrößenlimit überschreiten, steigen VARIANT_SIZE_LIMIT.
Häufige Fehlerbedingungen
Examples
-- Append to a root array
> SELECT try_variant_array_append(parse_json('[1]'), '$', 2)
[1,2]
-- Append to a nested array
> SELECT try_variant_array_append(parse_json('{"a": [1, 2]}'), '$.a', 3)
{"a":[1,2,3]}
-- Non-array target
> SELECT try_variant_array_append(parse_json('{"a": 1}'), '$.a', 2)
NULL
-- Missing path
> SELECT try_variant_array_append(parse_json('{"a": 1}'), '$.missing', 2)
{"a":1}
-- Invalid path
> SELECT try_variant_array_append(parse_json('[]'), 'invalid', 1)
Error: INVALID_VARIANT_PATH.