適用対象:
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