variant_delete 機能

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

指定されたパスにあるフィールドまたは配列要素を削除した variantExpr を返します。

Syntax

variant_delete ( variantExpr, path1 [, path2, ...] )

Arguments

  • variantExpr:その VARIANT 表現だ。
  • path1、path2、...: 削除するパスを指定する、よく整形された JSON パス式を持つ 1 つ以上の STRING 式。 配列インデックスはゼロベースです。

Returns

VARIANT 型の値。

パスは左から右へ、それぞれ前の削除の結果に適用されます。 配列要素を削除すると、次の要素が左にシフトします。

欠落したフィールド、範囲外インデックス、互換性のない中間型は無視されます。 空のオブジェクトや配列は保持されます。

variantExpr が SQL NULL の場合、結果は SQL NULL となります。 SQL NULL パスはスキップされます。

不適切なパスやルートパス$INVALID_VARIANT_PATH上昇させます。

一般的なエラー状態

使用例

-- Remove object fields
> SELECT variant_delete(parse_json('{"a": 1, "b": 2, "c": 3}'), '$.a', '$.c')
  {"b":2}

-- Remove an array element
> SELECT variant_delete(parse_json('[1, 2, 3]'), '$[1]')
  [1,3]

-- Apply paths from left to right
> SELECT variant_delete(parse_json('[1, 2, 3]'), '$[0]', '$[0]')
  [3]

-- Missing and incompatible paths
> SELECT variant_delete(parse_json('{"a": 1}'), '$.missing', '$.a.b')
  {"a":1}

-- Preserve an empty object
> SELECT variant_delete(parse_json('{"a": {"b": 1}}'), '$.a.b')
  {"a":{}}

-- Skip a SQL NULL path
> SELECT variant_delete(parse_json('{"a": 1, "b": 2}'), '$.a', CAST(NULL AS STRING))
  {"b":2}