variant_pick 機能

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

指定されたパスで選択されたvariantExprのフィールドと配列要素のみを含むVARIANTを返します。

Syntax

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

Arguments

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

Returns

VARIANT 型の値。

選択したフィールドや要素は親構造を保持します。 配列には、元の順序で選ばれた要素のみが含まれます。

パスの順序や重複は結果に影響を与えません。 親の選択には、そのすべての子が含まれます。 ルートパス $ 値全体を選択します。

欠落したフィールド、範囲外インデックス、互換性のない中間型は無視されます。 一致がない場合、オブジェクト入力と配列入力はそれぞれ {} と []を返します。 スカラーおよびバリアント null は変更されません。

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

歪んだ道は INVALID_VARIANT_PATHを上げる。

一般的なエラー状態

使用例

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

-- Select a nested field
> SELECT variant_pick(parse_json('{"a": {"b": 1, "c": 2}, "d": 3}'), '$.a.b')
  {"a":{"b":1}}

-- Preserve array order and ignore duplicate paths
> SELECT variant_pick(parse_json('[10, 20, 30, 40]'), '$[2]', '$[0]', '$[2]')
  [10,30]

-- Overlapping paths
> SELECT variant_pick(parse_json('{"a": {"b": 1, "c": 2}}'), '$.a.b', '$.a')
  {"a":{"b":1,"c":2}}

-- Missing path
> SELECT variant_pick(parse_json('{"a": {"b": 1}}'), '$.a.missing')
  {}

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