variant_strip_nulls 機能

適用対象:チェックマーク:はい Databricks SQL チェック はい Databricks ランタイム 19 以上

オブジェクトから再帰的に除去されたバリアント null フィールドと、オプションで配列から除去されたバリアント null 要素を含む variantExpr を返します。

Syntax

variant_strip_nulls ( variantExpr [, include_arrays] )

Arguments

  • variantExpr:その VARIANT 表現だ。
  • include_arrays: オプションの定数(折りたたみ可能な) BOOLEAN 式。 trueの場合、配列からバリエーションのnull要素を削除します。 既定値は true です。

Returns

VARIANT 型の値。

配列内のオブジェクト内の変異的な null フィールドは、 include_arrays が falseされても削除されます。

空のオブジェクトや配列、スカラー、およびトップレベルのバリアント null は保持されます。

SQL NULL 引数は SQL NULL を返します。 parse_json('null') のようなバリアント null は、SQL NULL とは異なるものです。 is_variant_nullをご覧ください。

使用例

-- 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