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 inserito come campo o elemento di array in path.
Syntax
variant_insert ( variantExpr, path, val )
Arguments
-
variantExpr: Un'espressioneVARIANT. -
path: Un'espressioneSTRINGcon un'espressione di percorso JSON ben formata. Gli indici degli array sono basati su zero. -
val: Un'espressione lancabile aVARIANT.
Returns
Valore di tipo VARIANT.
L'inserimento dell'array sposta gli elementi successivi verso destra. Un indice pari alla lunghezza dell'array aggiunge val. Un indice più grande riempie l'array con valori nulli varianti prima dell'inserimento.
Gli oggetti o array intermedi mancanti vengono creati in base al segmento di tracciato successivo.
Gli argomenti SQL NULL restituiscono SQL NULL.
I campi oggetto duplicati sollevano VARIANT_DUPLICATE_KEY. I tipi intermedi incompatibili sollevano VARIANT_PATH_TYPE_MISMATCH. Per restituire SQL NULL invece, usa try_variant_insert.
I percorsi malformati o il percorso $ della radice aumentano INVALID_VARIANT_PATH, e i risultati che superano il limite di dimensione della variante aumentano VARIANT_SIZE_LIMIT.
Condizioni di errore comuni
Examples
-- Insert an object field
> SELECT variant_insert(parse_json('{"a": 1}'), '$.b', 2)
{"a":1,"b":2}
-- Create a missing path
> SELECT variant_insert(parse_json('{}'), '$.a[0]', 1)
{"a":[1]}
-- Insert an array element
> SELECT variant_insert(parse_json('["a", "b", "c"]'), '$[1]', 'z')
["a","z","b","c"]
-- Pad an array with variant nulls
> SELECT variant_insert(parse_json('["a", "b"]'), '$[5]', 'z')
["a","b",null,null,null,"z"]
-- Insert a variant null
> SELECT variant_insert(parse_json('{"a": 1}'), '$.b', parse_json('null'))
{"a":1,"b":null}
-- SQL NULL argument
> SELECT variant_insert(parse_json('{"a": 1}'), '$.b', CAST(NULL AS VARIANT))
NULL
-- Duplicate object field
> SELECT variant_insert(parse_json('{"a": 1}'), '$.a', 2)
Error: VARIANT_DUPLICATE_KEY.