variant_strip_nulls Função

Aplica-se a:marcado sim Databricks SQL marcado sim Databricks 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: Uma VARIANT expressão.
  • include_arrays: Uma expressão constante opcional (dobrável BOOLEAN ). Se true, 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