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
Ritorna variantExpr con val inserito o impostato a path, o NULL per tipi intermedi incompatibili.
Syntax
try_variant_set ( variantExpr, path, val [, create_if_missing] )
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. -
create_if_missing: Un'espressione costante opzionale (pieghevoleBOOLEAN). Setrue, crea campi mancanti, elementi di array e oggetti o array intermedi lungopath. Il valore predefinito ètrue.
Returns
Valore di tipo VARIANT.
Se create_if_missing è false, un bersaglio o un percorso intermedio mancante rimane variantExpr invariato.
Gli argomenti SQL NULL restituiscono SQL NULL.
La funzione restituisce SQL NULL per tipi intermedi incompatibili. Per generare un errore invece, usa variant_set.
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
-- Replace an object field
> SELECT try_variant_set(parse_json('{"a": 1}'), '$.a', 99)
{"a":99}
-- Incompatible path
> SELECT try_variant_set(parse_json('{"a": 1}'), '$.a.b', 2)
NULL
-- Missing path with creation disabled
> SELECT try_variant_set(parse_json('{"a": 1}'), '$.b', 2, false)
{"a":1}
-- Invalid root path
> SELECT try_variant_set(parse_json('{}'), '$', 1)
Error: INVALID_VARIANT_PATH.