array_insert işlevi

Şunlar için geçerlidir:onay işareti evet olarak işaretlenmiş Databricks SQL onay işareti evet olarak işaretlenmiş Databricks Runtime 13.3 LTS ve üzeri

Genişletilmiş bir array'u, elem'in index konumuna eklendiği şekilde döndürür.

Söz dizimi

array_insert(array, index, elem)

Tartışmalar

  • array: Bir Dizi.
  • index: elemnereye ekleneceğini belirten sıfır olmayan INTEGER ifadesi. Dizin negatifse elem , dizinin sonuna göre eklenir.
  • elem: array ögeleriyle aynı türde bir ifade.

İadeler

ile aynı türde arraybir ARRAY.

0 ise Azure Databricks index yükseltir.

sonuç dizi boyutu sınırını aşarsa Azure Databricks COLLECTION_SIZE_LIMIT_EXCEEDED oluşturur.

Notlar

index ile başlayan tüm öğeler, elem konumunda index için yer açmak üzere bir pozisyon kaydırılır. Eğer index, array'in kardinalitesinin dışındaysa dizi NULL ile doldurulur.

Yaygın hata koşulları

Örnekler

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

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

> 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"]
  • Last updated on