Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gilt für:
, Databricks, SQL,
, 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: EinVARIANTAusdruck. -
include_arrays: Ein optionaler konstanter (faltbarer)BOOLEANAusdruck. Wenntrue, entfernt variante Null-Elemente aus Arrays. Der Standardwert lautettrue.
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