次の方法で共有

array_insert 関数

  • [アーティクル]

適用対象: check marked yes Databricks SQL Databricks Runtime 13.3 LTS 以上

index の位置に elem を挿入して拡張された array を返します。

構文

array_insert(array, index, elem)

引数

  • array: 配列。
  • index: elem を挿入する場所を指定する 0 以外の INTEGER 式。 インデックスが負の場合は、elem は配列の末尾を基準にして挿入されます。
  • elem: array の要素と同じ型の式。

返品

array と同じ型の配列。

メモ

index で始まるすべての要素の位置は、index で elem のためのスペースを確保するために 1 つシフトされます。 index が array のカーディナリティの外側にある場合、配列には NULL が埋め込まれます。

例

> SELECT array_insert(array('a', 'b', 'c'), 1, 'z');
 ["z","a","b","c"]

> SELECT array_insert(array('a', 'b', 'c'), 0, 'z');
 Error

> SELECT array_insert(array('a', 'b', 'c'), -1, 'z');
 ["a","b","c","z"]

> SELECT array_insert(array('a', 'b', 'c'), 5, 'z');
 ["a","b","c",NULL,"z"]

> SELECT array_insert(array('a', 'b', 'c'), -5, 'z');
 ["z",NULL,"a","b","c"]

> SELECT array_insert(array('a', 'b', 'c'), 2, cast(NULL AS STRING));
 ["a",NULL,"b","c"]