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