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 i campi null variant rimossi ricorsivamente dagli oggetti e, opzionalmente, elementi null variant rimossi dagli array.
Syntax
variant_strip_nulls ( variantExpr [, include_arrays] )
Arguments
-
variantExpr: Un'espressioneVARIANT. -
include_arrays: Un'espressione costante opzionale (pieghevoleBOOLEAN). Setrue, rimuove elementi nulli varianti dagli array. Il valore predefinito ètrue.
Returns
Valore di tipo VARIANT.
I campi null varianti negli oggetti all'interno degli array vengono rimossi anche quando include_arrays è false.
Vengono preservati oggetti vuoti e array, scalari e varianti null di livello superiore.
Gli argomenti SQL NULL restituiscono SQL NULL. I null varianti, come parse_json('null'), sono distinti da SQL NULL. Vedi is_variant_null.
Examples
-- Remove null object fields
> SELECT variant_strip_nulls(parse_json('{"a": 1, "b": null, "c": 3}'))
{"a":1,"c":3}
-- Remove null array elements
> SELECT variant_strip_nulls(parse_json('[1, null, 3]'))
[1,3]
-- Preserve null array elements
> SELECT variant_strip_nulls(parse_json('[{"a": 1, "b": null}, null]'), false)
[{"a":1},null]
-- Preserve an empty object
> SELECT variant_strip_nulls(parse_json('{"a": {"b": null}}'))
{"a":{}}
-- Variant null input
> SELECT variant_strip_nulls(parse_json('null'))
null
-- SQL NULL input
> SELECT variant_strip_nulls(CAST(NULL AS VARIANT))
NULL