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 an das Array angehängt bei pathzurück.
Syntax
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.
val wird als ein Element angehängt, sodass das Anfügen eines Arrays ein verschachteltes Array erzeugt.
SQL-Argumente NULL geben SQL NULLzurück.
Inkompatible Zwischentypen oder ein Nicht-Array-Ziel erheben VARIANT_PATH_TYPE_MISMATCH. Um stattdessen SQL NULL zurückzugeben, verwenden Sie try_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 variant_array_append(parse_json('[1, 2, 3]'), '$', 4)
[1,2,3,4]
-- Append to a nested array
> SELECT variant_array_append(parse_json('{"a": [1, 2]}'), '$.a', 3)
{"a":[1,2,3]}
-- Append an array as a single element
> SELECT variant_array_append(parse_json('[1]'), '$', parse_json('[2, 3]'))
[1,[2,3]]
-- Missing path
> SELECT variant_array_append(parse_json('{"a": 1}'), '$.missing', 2)
{"a":1}
-- Non-array target
> SELECT variant_array_append(parse_json('{"a": 1}'), '$.a', 2)
Error: VARIANT_PATH_TYPE_MISMATCH.