variant_array_append 機能

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

配列にvalpath が追加されたvariantExprを返します。

Syntax

variant_array_append ( variantExpr, path, val )

Arguments

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

Returns

VARIANT 型の値。

抜けた道筋は variantExpr 変わらないまま残ります。 val 1つの要素として追加されるため、配列を追加すると入れ子配列が作成されます。

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

非互換性の中間型や非配列ターゲットが VARIANT_PATH_TYPE_MISMATCHを発生させます。 代わりに SQL NULL を返すには、 try_variant_array_append を使用します。

形状の悪い経路は INVALID_VARIANT_PATHを上げ、バリアントサイズ制限を超える結果は VARIANT_SIZE_LIMIT上昇します。

一般的なエラー状態

使用例

-- Append to a root array
> SELECT variant_array_append(parse_json('[1, 2, 3]'), '$', 4)
  [1,2,3,4]

-- Append to a nested array
> SELECT variant_array_append(parse_json('{"a": [1, 2]}'), '$.a', 3)
  {"a":[1,2,3]}

-- Append an array as a single element
> SELECT variant_array_append(parse_json('[1]'), '$', parse_json('[2, 3]'))
  [1,[2,3]]

-- Missing path
> SELECT variant_array_append(parse_json('{"a": 1}'), '$.missing', 2)
  {"a":1}

-- Non-array target
> SELECT variant_array_append(parse_json('{"a": 1}'), '$.a', 2)
  Error: VARIANT_PATH_TYPE_MISMATCH.