array_insert
işlevi
Şunlar için geçerlidir: Databricks SQL Databricks Runtime 13.3 LTS ve üzeri
Konuma eklenen index
genişletilmiş array
elem
bir döndürür.
Söz dizimi
array_insert(array, index, elem)
Bağımsız değişkenler
array
: Dizi.index
: Nereye ekleneceğinielem
belirten sıfır olmayan INTEGER ifadesi. Dizin negatifseelem
, dizinin sonuna göre eklenir.elem
: öğesiyle aynı türde birarray
ifade.
Döndürülenler
ile aynı türde array
bir ARRAY.
Notlar
ile index
başlayan tüm öğeler, konumunda index
yer açmak için elem
bir konum kaydırılır.
Dizi kardinalitesinin array
dışındaysa index
s ile NULL
doldurulur.
Örnekler
> 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"]