適用対象:
Databricks SQL
はい Databricks ランタイム 19 以上
pathに挿入または設定されたval、互換性のない中間型の場合はNULLを返すvariantExprを返します。
Syntax
try_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がfalseされている場合、欠落したターゲットパスまたは中間パスはvariantExpr変更されません。
SQL NULL 引数は SQL NULL を返します。
この関数は、互換性のない中間型に対して SQL NULL を返します。 エラーを出す場合は variant_setを使用します。
不正なパスやルートパス$上昇し、バリアントサイズ制限を超えると INVALID_VARIANT_PATH VARIANT_SIZE_LIMIT が上がります。
一般的なエラー状態
使用例
-- Replace an object field
> SELECT try_variant_set(parse_json('{"a": 1}'), '$.a', 99)
{"a":99}
-- Incompatible path
> SELECT try_variant_set(parse_json('{"a": 1}'), '$.a.b', 2)
NULL
-- Missing path with creation disabled
> SELECT try_variant_set(parse_json('{"a": 1}'), '$.b', 2, false)
{"a":1}
-- Invalid root path
> SELECT try_variant_set(parse_json('{}'), '$', 1)
Error: INVALID_VARIANT_PATH.