Remarque
L’accès à cette page requiert une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page requiert une autorisation. Vous pouvez essayer de modifier des répertoires.
S’applique à :
SQL
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: UneVARIANTexpression. -
include_arrays: Une expression constante optionnelle (pliableBOOLEAN). Sitrue, supprime les éléments nul variants des tableaux. La valeur par défaut esttrue.
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