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, oppure NULL se un valore intermedio ha un tipo incompatibile o se il target non è un array.
Syntax
try_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.
Gli argomenti SQL NULL restituiscono SQL NULL.
La funzione restituisce SQL NULL per tipi intermedi incompatibili o per un target non di array. Per generare un errore invece, usa 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 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.