variant_strip_nulls Fonction

S’applique à :coché oui Databricks SQL coché oui Databricks Runtime 19 et supérieur

Renvoie variantExpr les champs null variants supprimés récursivement des objets et, éventuellement, les éléments nul variants supprimés des tableaux.

Syntax

variant_strip_nulls ( variantExpr [, include_arrays] )

Arguments

  • variantExpr: Une VARIANT expression.
  • include_arrays: Une expression constante optionnelle (pliable BOOLEAN ). Si true, supprime les éléments nul variants des tableaux. La valeur par défaut est true.

Returns

Valeur de type VARIANT.

Les champs nul variants dans les objets à l’intérieur de tableaux sont supprimés même lorsque include_arrays est false.

Les objets et tableaux vides, les scalaires et les nulls variants de niveau supérieur sont conservés.

Les arguments SQL NULL retournent SQL NULL. Les nulls variants, tels que parse_json('null'), sont distincts de SQL NULL. Voir 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