Udostępnij za pośrednictwem

INVALID_ARRAY_INDEX, klasa błędu

  • Artykuł

SQLSTATE: 22003

Indeks <indexValue> jest poza granicami. Tablica ma <arraySize> elementów. Użyj funkcji SQL get(), aby tolerować dostęp do elementu w nieprawidłowym indeksie i zamiast tego zwracać wartość NULL. W razie potrzeby ustaw <ansiConfig> na wartość "false", aby pominąć ten błąd.

Parametry

  • indexValue: żądany indeks w tablicy.
  • arraySize: kardynalność tablicy.
  • ansiConfig: ustawienie konfiguracji umożliwiające zmianę trybu ANSI.

Wyjaśnienie

W przeciwieństwie do element_at i elt, odwołanie indexValue do tablicy przy użyciu składni arrayExpr[indexValue] musi być w zakresie od 0 dla pierwszego elementu do arraySize - 1 dla ostatniego elementu.

Wartość ujemna indexValue lub wartość większa lub równa arraySize jest niedozwolona.

Łagodzenia

Ograniczenie ryzyka dla tego błędu zależy od intencji:

Przykłady

-- 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;