INVALID_ARRAY_INDEX třída chyb

SQLSTATE: 22003

Index <indexValue> je mimo povolené hranice. Pole obsahuje <arraySize> elementy. Pomocí funkce SQL get() tolerujte přístup k elementu v neplatném indexu a místo toho vraťte hodnotu NULL. V případě potřeby nastavte <ansiConfig> na false, aby se tato chyba vynechala.

Parametry

• indexValue: Požadovaný index do pole.
• arraySize: Počet prvků v poli.
• ansiConfig: Nastavení konfigurace pro změnu režimu ANSI.

Vysvětlení

Na rozdíl od prvků element_at a eltmusí být odkaz indexValue do pole pomocí syntaxe arrayExpr[indexValue] mezi 0 pro první prvek a arraySize - 1 pro poslední prvek.

Záporná indexValue nebo hodnota větší nebo rovna arraySize není povolená.

Zmírnění

Zmírnění této chyby závisí na záměru:

• Předpokládá poskytnuté indexValue indexování založené na 1?

  Použijte element_at(arrayExpr, indexValue), elt(arrayExpr, indexValue)nebo arrayExpr[indexValue - 1] k určení správného prvku pole.

• Je indexValue číslo negativní při očekávání načítání prvku relativně ke konci pole?

  Použijte element_at(arrayExpr, indexValue) nebo elt(arrayExpr, indexValue)'. V případě potřeby upravte indexování na indexování s počátkem od 1.

• Očekáváte, že se pro prvky mimo kardinalitu indexu vrátí hodnota NULL?

  Pokud můžete výraz změnit, použijte try_element_at(arrayExpr, indexValue + 1), aby bylo možné tolerovat odkazy mimo rozsah. Všimněte si indexování založené na 1 pro try_element_at.

  Pokud výraz nemůžete změnit, jako krajní možnost dočasně nastavte ansiConfig na false, abyste tolerovali odkazy mimo rozsah.

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;

Související

• [ ] (operátor závorky)
• ANSI_MODE
• funkce element_at
• funkce elt
• funkce try_element_at