INVALID_ARRAY_INDEX hata sınıfı
Dizin <indexValue>
sınırların dışında. Dizinin öğeleri vardır <arraySize>
. Geçersiz dizindeki öğeye erişimi tolere etmek ve bunun yerine NULL döndürmek için SQL işlevini get()
kullanın. Gerekirse bu hatayı atlamak için "false" olarak ayarlayın <ansiConfig>
.
Parametre
- indexValue: Dizide istenen dizin.
- arraySize: Dizinin kardinalitesi.
- ansiConfig: ANSI modunu değiştirmek için yapılandırma ayarı.
Açıklama
element_at ve elt'in aksine, arrayExpr[indexValue] söz dizimini kullanan bir diziye başvuruindexValue
, ilk öğe ile son öğe arraySize - 1
için arasında 0
olmalıdır.
Negatif indexValue
veya değerine daha büyük veya eşit bir değere arraySize
izin verilmez.
Azaltma
Bu hatanın hafifletilmesi amacına bağlıdır:
Sağlanan
indexValue
1 tabanlı dizin oluşturma varsayılır mı?Doğru dizi öğesini çözümlemek için element_at(arrayExpr, indexValue), elt(arrayExpr, indexValue)' veya arrayExpr[indexValue - 1] kullanın.
Negatif öğenin
indexValue
dizinin sonuna göre alınmasını bekliyor mu?element_at(arrayExpr, indexValue) veya elt(arrayExpr, indexValue)' kullanın. Gerekirse 1 tabanlı dizin oluşturma için ayarlayın.
Dizinin kardinalitesi dışındaki öğeler için döndürülecek bir
NULL
değer almayı bekliyor musunuz?İfadeyi değiştirebiliyorsanız, try_element_at (arrayExpr, indexValue + 1) kullanarak başvuruları sınır dışı olarak kabul edin. için
try_element_at
1 tabanlı dizine dikkat edin.İfadeyi değiştiremiyorsanız, son çare olarak öğesini geçici olarak başvurulara izin veremeyecek şekilde
false
ayarlayınansiConfig
.
Örnekler
-- An INVALID_ARRAY_INDEX error because of mismatched indexing
> SELECT array('a', 'b', 'c')[index] FROM VALUES(1), (3) AS T(index);
[INVALID_ARRAY_INDEX] The index 3 is out of bounds. The array has 3 elements. If necessary set "ANSI_MODE" to false to bypass this error.
-- Using element_at instead for 1-based indexing
> SELECT element_at(array('a', 'b', 'c'), index) FROM VALUES(1), (3) AS T(index);
a
c
-- Adjusting the index to be 0-based
> SELECT array('a', 'b', 'c')[index -1] FROM VALUES(1), (3) AS T(index);
-- Tolerating out of bound array index with adjustment to 1-based indexing
> SELECT try_element_at(array('a', 'b', 'c'), index + 1) FROM VALUES(1), (3) AS T(index);
b
NULL
-- An INVALID_ARRAY_INDEX error because of negative index
> SELECT array('a', 'b', 'c')[index] FROM VALUES(-1), (2) AS T(index);
[INVALID_ARRAY_INDEX] The index -1 is out of bounds. The array has 3 elements. If necessary set "ANSI_MODE" to "false" to bypass this error.
-- Using element_at to index relative to the end of the array
> SELECT element_at(array('a', 'b', 'c'), index) FROM VALUES(-1), (2) AS T(index);
c
b
-- Tolerating an out of bound index by setting ansiConfig in Databricks SQL
> SET ANSI_MODE = false;
> SELECT array('a', 'b', 'c')[index] FROM VALUES(1), (3) AS T(index);
b
NULL
> SET ANSI_MODE = true;
-- Tolerating an out of bound index by setting ansiConfig in Databricks Runtime
> SET spark.sql.ansi.enabled = false;
> SELECT array('a', 'b', 'c')[index] FROM VALUES(1), (3) AS T(index);
b
NULL
> SET spark.sql.ansi.enabled = true;