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 un VARIANT contenente solo i campi e gli elementi dell'array selezionati variantExpr dai percorsi specificati.
Syntax
variant_pick ( 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 mantenere. Gli indici degli array sono basati su zero.
Returns
Valore di tipo VARIANT.
I campi e gli elementi selezionati mantengono la loro struttura genitore. Gli array contengono solo elementi selezionati, nel loro ordine originale.
L'ordine dei percorsi e i duplicati non influenzano il risultato. La selezione di un genitore include tutti i suoi figli. Il percorso $ radice seleziona l'intero valore.
I campi mancanti, gli indici fuori intervallo e i tipi intermedi incompatibili vengono ignorati. Senza corrispondenze, gli input di oggetto e array restituiscono {} rispettivamente e [], . Gli scalari e i nulli varianti restano invariati.
Se variantExpr è SQL NULL, il risultato è SQL NULL. I percorsi SQL NULL vengono saltati.
I percorsi deformati sollevano INVALID_VARIANT_PATH.
Condizioni di errore comuni
Examples
-- Select object fields
> SELECT variant_pick(parse_json('{"a": 1, "b": 2, "c": 3}'), '$.a', '$.c')
{"a":1,"c":3}
-- Select a nested field
> SELECT variant_pick(parse_json('{"a": {"b": 1, "c": 2}, "d": 3}'), '$.a.b')
{"a":{"b":1}}
-- Preserve array order and ignore duplicate paths
> SELECT variant_pick(parse_json('[10, 20, 30, 40]'), '$[2]', '$[0]', '$[2]')
[10,30]
-- Overlapping paths
> SELECT variant_pick(parse_json('{"a": {"b": 1, "c": 2}}'), '$.a.b', '$.a')
{"a":{"b":1,"c":2}}
-- Missing path
> SELECT variant_pick(parse_json('{"a": {"b": 1}}'), '$.a.missing')
{}
-- Skip a SQL NULL path
> SELECT variant_pick(parse_json('{"a": 1, "b": 2}'), '$.a', CAST(NULL AS STRING))
{"a":1}