try_variant_insert 機能

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

pathに挿入されたvalがvariantExprを返し、重複したオブジェクトフィールドや互換性のない中間型の場合はNULLを返します。

Syntax

try_variant_insert ( variantExpr, path, val )

Arguments

  • variantExpr:その VARIANT 表現だ。
  • path: よく整った JSON パス式を持つ STRING 式。 配列インデックスはゼロベースです。
  • val: VARIANTに唱えられる表現。

Returns

VARIANT 型の値。

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

関数は重複したオブジェクトフィールドや互換性のない中間型に対して SQL NULL を返します。 エラーを出す場合は、 variant_insert を使用してください。

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

一般的なエラー状態

使用例

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

-- Duplicate object field
> SELECT try_variant_insert(parse_json('{"a": 1}'), '$.a', 2)
  NULL

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

-- Invalid root path
> SELECT try_variant_insert(parse_json('{}'), '$', 1)
  Error: INVALID_VARIANT_PATH.