適用対象:
Databricks SQL
はい Databricks ランタイム 19 以上
配列にvalが付加されてpathに付加されたvariantExpr返し、中間値の型が互換でない場合やターゲットが配列でない場合はNULL返します。
Syntax
try_variant_array_append ( variantExpr, path, val )
Arguments
-
variantExpr:そのVARIANT表現だ。 -
path: ターゲット配列を指定する、よく整った JSON パス式を持つSTRING式。 配列インデックスはゼロベースです。 -
val:VARIANTに唱えられる表現。
Returns
VARIANT 型の値。
抜けた道筋は variantExpr 変わらないまま残ります。
SQL NULL 引数は SQL NULL を返します。
関数は互換性のない中間型や非配列ターゲットに対して SQL NULL を返します。 エラーを出す場合は、 variant_array_append を使用します。
形状の悪い経路は INVALID_VARIANT_PATHを上げ、バリアントサイズ制限を超える結果は VARIANT_SIZE_LIMIT上昇します。
一般的なエラー状態
使用例
-- Append to a root array
> SELECT try_variant_array_append(parse_json('[1]'), '$', 2)
[1,2]
-- Append to a nested array
> SELECT try_variant_array_append(parse_json('{"a": [1, 2]}'), '$.a', 3)
{"a":[1,2,3]}
-- Non-array target
> SELECT try_variant_array_append(parse_json('{"a": 1}'), '$.a', 2)
NULL
-- Missing path
> SELECT try_variant_array_append(parse_json('{"a": 1}'), '$.missing', 2)
{"a":1}
-- Invalid path
> SELECT try_variant_array_append(parse_json('[]'), 'invalid', 1)
Error: INVALID_VARIANT_PATH.