INVALID_ARRAY_INDEX kelas kesalahan
Indeks <indexValue>
berada di luar batas. Array memiliki <arraySize>
elemen. Gunakan fungsi get()
SQL untuk mentolerir akses elemen pada indeks yang tidak valid dan mengembalikan NULL sebagai gantinya. Jika perlu diatur <ansiConfig>
ke "false" untuk melewati kesalahan ini.
Parameter
- indexValue: Indeks yang diminta ke dalam array.
- arraySize: Kardinalitas array.
- ansiConfig: Pengaturan konfigurasi untuk mengubah mode ANSI.
Penjelasan
Tidak seperti element_at dan elt, referensi indexValue
ke dalam array menggunakan sintaks arrayExpr[indexValue] harus antara 0
untuk elemen pertama dan arraySize - 1
untuk elemen terakhir.
Negatif indexValue
atau nilai yang lebih besar atau sama dengan arraySize
tidak diperbolehkan.
Mitigasi
Mitigasi untuk kesalahan ini tergantung pada niatnya:
Apakah yang disediakan
indexValue
mengasumsikan pengindeksan berbasis 1?Gunakan element_at(arrayExpr, indexValue), elt(arrayExpr, indexValue)', atau arrayExpr[indexValue - 1] untuk menyelesaikan elemen array yang benar.
indexValue
Apakah negatif mengharapkan untuk mengambil elemen relatif terhadap akhir array?Gunakan element_at(arrayExpr, indexValue) atau elt(arrayExpr, indexValue)'. Sesuaikan untuk pengindeksan berbasis 1 jika perlu.
Apakah Anda berharap untuk mendapatkan nilai yang
NULL
akan dikembalikan untuk elemen di luar kardinalitas indeks?Jika Anda dapat mengubah ekspresi, gunakan try_element_at(arrayExpr, indexValue + 1) untuk mentolerir referensi di luar batas. Perhatikan pengindeksan berbasis 1 untuk
try_element_at
.Jika Anda tidak dapat mengubah ekspresi, sebagai upaya terakhir, atur
ansiConfig
sementara kefalse
untuk mentolerir referensi di luar batas.
Contoh
-- 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;