Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Aplica-se a:
SQL
Runtime 19 e superior
Retorna variantExpr com campos nulos variantes recursivamente removidos de objetos e, opcionalmente, elementos nulos variantes removidos de arrays.
Sintaxe
variant_strip_nulls ( variantExpr [, include_arrays] )
Arguments
-
variantExpr: UmaVARIANTexpressão. -
include_arrays: Uma expressão constante opcional (dobrávelBOOLEAN). Setrue, remove elementos nulos variantes de arrays. O padrão étrue.
Returns
Um valor do tipo VARIANT.
Campos nulos variantes em objetos dentro de arrays são removidos mesmo quando include_arrays é false.
Objetos vazios e arrays, escalares e variantes nulas de nível superior são preservados.
Argumentos SQL NULL retornam SQL NULL. Nulos variantes, como parse_json('null'), são distintos do SQL NULL. Veja 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