Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Si applica a:
SQL
Databricks Runtime 19 e superiori
Restituisce variantExpr con val aggiunto all'array in path.
Syntax
variant_array_append ( variantExpr, path, val )
Arguments
-
variantExpr: Un'espressioneVARIANT. -
path: Un'espressioneSTRINGcon un'espressione di percorso JSON ben formata che specifica l'array target. Gli indici degli array sono basati su zero. -
val: Un'espressione lancabile aVARIANT.
Returns
Valore di tipo VARIANT.
Un percorso mancante rimane variantExpr invariato.
val viene aggiunto come un singolo elemento, quindi aggiungere un array crea un array annidato.
Gli argomenti SQL NULL restituiscono SQL NULL.
Tipi intermedi incompatibili o un target non array aumentano VARIANT_PATH_TYPE_MISMATCH. Per restituire SQL NULL invece, usa try_variant_array_append.
I percorsi malformati aumentano INVALID_VARIANT_PATH, e i risultati che superano il limite di dimensione della variante aumentano VARIANT_SIZE_LIMIT.
Condizioni di errore comuni
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.