INVALID_ARRAY_INDEX třída chyby
Index <indexValue> je mimo rozsah. Pole obsahuje <arraySize> prvky. Pomocí funkce get() SQL tolerujte přístup k elementu při neplatném indexu a místo toho vraceli hodnotu NULL. Pokud je to nutné, nastavte <ansiConfig> hodnotu false, aby se tato chyba vynechala.
Parametry
- indexValue: Požadovaný index do pole.
- arraySize: Kardinalita pole.
- ansiConfig: Nastavení konfigurace pro změnu režimu ANSI.
Vysvětlení
Na rozdíl od element_at a elt musí odkaz indexValue na pole pomocí syntaxe arrayExpr[indexValue] být mezi 0 prvním a arraySize - 1 posledním elementem.
Záporná indexValue hodnota nebo hodnota větší nebo rovna arraySize není povolena.
Zmírnění
Zmírnění této chyby závisí na záměru:
Předpokládá se u zadaného
indexValueindexování na základě 1?Pomocí element_at(arrayExpr, indexValue), elt(arrayExpr, indexValue) nebo arrayExpr[indexValue - 1] přeložte správný prvek pole.
indexValueJe záporná očekávání načtení elementu relativní ke konci pole?Použijte element_at(arrayExpr, indexValue) nebo elt(arrayExpr, indexValue). V případě potřeby upravte indexování založené na 1.
Očekáváte, že získáte hodnotu, která
NULLse vrátí pro prvky mimo kardinalitu indexu?Pokud můžete výraz změnit, použijte try_element_at(arrayExpr, indexValue + 1) k tolerování odkazů mimo vazbu. Všimněte si indexování založené na 1 pro
try_element_at.Pokud nemůžete výraz změnit, jako poslední možnost, dočasně nastavte
ansiConfigna ,falseaby se odkazy netoleroval mimo hranici.
Příklady
-- 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;