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 i campi o gli elementi dell'array nei percorsi specificati rimossi.
Syntax
variant_delete ( variantExpr, path1 [, path2, ...] )
Arguments
-
variantExpr: Un'espressioneVARIANT. -
path1,path2, ...: Una o piùSTRINGespressioni con espressioni di percorso JSON ben formate che specificano i percorsi da rimuovere. Gli indici degli array sono basati su zero.
Returns
Valore di tipo VARIANT.
I tracciati vengono applicati da sinistra a destra al risultato di ogni eliminazione precedente. L'eliminazione di un elemento dell'array sposta gli elementi successivi verso sinistra.
I campi mancanti, gli indici fuori intervallo e i tipi intermedi incompatibili vengono ignorati. Gli oggetti e gli array vuoti vengono preservati.
Se variantExpr è SQL NULL, il risultato è SQL NULL. I percorsi SQL NULL vengono saltati.
I percorsi malformati o il percorso $ delle radici aumentano INVALID_VARIANT_PATH.
Condizioni di errore comuni
Examples
-- Remove object fields
> SELECT variant_delete(parse_json('{"a": 1, "b": 2, "c": 3}'), '$.a', '$.c')
{"b":2}
-- Remove an array element
> SELECT variant_delete(parse_json('[1, 2, 3]'), '$[1]')
[1,3]
-- Apply paths from left to right
> SELECT variant_delete(parse_json('[1, 2, 3]'), '$[0]', '$[0]')
[3]
-- Missing and incompatible paths
> SELECT variant_delete(parse_json('{"a": 1}'), '$.missing', '$.a.b')
{"a":1}
-- Preserve an empty object
> SELECT variant_delete(parse_json('{"a": {"b": 1}}'), '$.a.b')
{"a":{}}
-- Skip a SQL NULL path
> SELECT variant_delete(parse_json('{"a": 1, "b": 2}'), '$.a', CAST(NULL AS STRING))
{"b":2}