variant_set 機能

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

valが挿入または設定されたvariantExprを返path。

Syntax

variant_set ( variantExpr, path, val [, create_if_missing] )

Arguments

  • variantExpr:その VARIANT 表現だ。
  • path: よく整った JSON パス式を持つ STRING 式。 配列インデックスはゼロベースです。
  • val: VARIANTに唱えられる表現。
  • create_if_missing: オプションの定数(折りたたみ可能な) BOOLEAN 式。 trueの場合、欠落フィールド、配列要素、path沿いに中間オブジェクトや配列を作成します。 既定値は true です。

Returns

VARIANT 型の値。

配列要素を置き換えても他の要素はシフトしません。

create_if_missingがtrueされている場合、欠落したフィールドや中間コンテナが作成されます。 配列の長さに等しいインデックスが valを追加します。 より大きなインデックスが配列にバリエーションのnullを埋めてから valを追加します。

create_if_missingがfalseされている場合、欠落したターゲットパスまたは中間パスはvariantExpr変更されません。

SQL NULL 引数は SQL NULL を返します。

互換性のない中間型はcreate_if_missingに関係なくVARIANT_PATH_TYPE_MISMATCHを上げます。 代わりに SQL NULL を返すには、 try_variant_set を使用します。

不正なパスやルートパス$上昇し、バリアントサイズ制限を超えると INVALID_VARIANT_PATH VARIANT_SIZE_LIMIT が上がります。

一般的なエラー状態

使用例

-- Replace an object field
> SELECT variant_set(parse_json('{"a": 1}'), '$.a', 2)
  {"a":2}

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

-- Replace an array element
> SELECT variant_set(parse_json('["a", "b", "c"]'), '$[1]', 'z')
  ["a","z","c"]

-- Append at the array length
> SELECT variant_set(parse_json('["a", "b", "c"]'), '$[3]', 'z')
  ["a","b","c","z"]

-- Missing path with creation disabled
> SELECT variant_set(parse_json('{"a": 1}'), '$.b', 2, false)
  {"a":1}

-- Incompatible path
> SELECT variant_set(parse_json('{"a": 1}'), '$.a.b', 2)
  Error: VARIANT_PATH_TYPE_MISMATCH.