variant_insert 機能

適用対象:チェックマーク:はい 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.