Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Se aplica a:
SQL
Runtime 19 y superior
Devuelve variantExpr con los campos nulos variant eliminados recursivamente de los objetos y, opcionalmente, con elementos nulos variant eliminados de los arrays.
Syntax
variant_strip_nulls ( variantExpr [, include_arrays] )
Argumentos
-
variantExpr: UnaVARIANTexpresión. -
include_arrays: Una expresión constante opcional (plegableBOOLEAN). Sitrue, elimina elementos nulos variantes de los arrays. El valor predeterminado estrue.
Returns
Valor de tipo VARIANT.
Los campos nulos variantes en objetos dentro de matrices se eliminan incluso cuando include_arrays es false.
Se conservan los objetos vacíos y los arrays, escalares y variantes nulas de nivel superior.
Los argumentos SQL NULL devuelven SQL NULL. Los nulos variantes, como parse_json('null'), son distintos de SQL NULL. Véase 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