variant_strip_nulls Funzione

Si applica a:spuntato sì Databricks SQL contrassegnato sì 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'espressione VARIANT .
  • include_arrays: Un'espressione costante opzionale (pieghevole BOOLEAN ). Se true, 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