適用対象:
Databricks SQL
はい Databricks ランタイム 19 以上
path にフィールドまたは配列要素として挿入されたvariantExprval を返します。
Syntax
variant_insert ( variantExpr, path, val )
Arguments
-
variantExpr:そのVARIANT表現だ。 -
path: よく整った JSON パス式を持つSTRING式。 配列インデックスはゼロベースです。 -
val:VARIANTに唱えられる表現。
Returns
VARIANT 型の値。
配列挿入は次の要素を右にシフトさせます。 配列の長さに等しいインデックスが valを追加します。 挿入前に、より大きなインデックスが配列にバリアント null を埋めます。
欠落している中間オブジェクトや配列は、次のパスセグメントに従って作成されます。
SQL NULL 引数は SQL NULL を返します。
オブジェクトフィールドを重複すると VARIANT_DUPLICATE_KEYが上がります。 互換性のない中間型は VARIANT_PATH_TYPE_MISMATCHを上げます。 代わりに SQL NULL を返すには、 try_variant_insert を使用します。
不正なパスやルートパス$上昇し、バリアントサイズ制限を超えると INVALID_VARIANT_PATH VARIANT_SIZE_LIMIT が上がります。
一般的なエラー状態
使用例
-- Insert an object field
> SELECT variant_insert(parse_json('{"a": 1}'), '$.b', 2)
{"a":1,"b":2}
-- Create a missing path
> SELECT variant_insert(parse_json('{}'), '$.a[0]', 1)
{"a":[1]}
-- Insert an array element
> SELECT variant_insert(parse_json('["a", "b", "c"]'), '$[1]', 'z')
["a","z","b","c"]
-- Pad an array with variant nulls
> SELECT variant_insert(parse_json('["a", "b"]'), '$[5]', 'z')
["a","b",null,null,null,"z"]
-- Insert a variant null
> SELECT variant_insert(parse_json('{"a": 1}'), '$.b', parse_json('null'))
{"a":1,"b":null}
-- SQL NULL argument
> SELECT variant_insert(parse_json('{"a": 1}'), '$.b', CAST(NULL AS VARIANT))
NULL
-- Duplicate object field
> SELECT variant_insert(parse_json('{"a": 1}'), '$.a', 2)
Error: VARIANT_DUPLICATE_KEY.