variant_strip_nulls Funktion

Gilt für:Angekreuzt ja, Databricks, SQL, angekreuzt ja, Databricks, Laufzeit 19 und höher.

Gibt variantExpr Variant-Null-Felder zurück, die rekursiv aus Objekten entfernt werden, und optional Variant-Null-Elemente, die aus Arrays entfernt werden.

Syntax

variant_strip_nulls ( variantExpr [, include_arrays] )

Argumente

  • variantExpr: Ein VARIANT Ausdruck.
  • include_arrays: Ein optionaler konstanter (faltbarer) BOOLEAN Ausdruck. Wenn true, entfernt variante Null-Elemente aus Arrays. Der Standardwert lautet true.

Returns

Ein Wert vom Typ VARIANT.

Variante Nullfelder in Objekten innerhalb von Arrays werden entfernt, selbst wenn include_arrays .false

Leere Objekte und Arrays, Skalare sowie oberstufige Variant-Nulls werden erhalten.

SQL-Argumente NULL geben SQL NULLzurück. Variante Nullwerte, wie parse_json('null'), unterscheiden sich von SQL NULL. Sieh 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