Поделиться через

INVALID_ARRAY_INDEX error condition

SQLSTATE: 22003

The index <indexValue> is out of bounds. The array has <arraySize> elements. Use the SQL function get() to tolerate accessing element at invalid index and return NULL instead. Если необходимо, установите <ansiConfig> на "false", чтобы обойти эту ошибку.

Параметры

  • indexValue: запрошенный индекс в массиве.
  • arraySize: кратность массива.
  • ansiConfig: параметр конфигурации для изменения режима ANSI.

Объяснение

В отличие от element_at и elt, ссылка indexValue в массив с помощью синтаксиса arrayExpr[indexValue] должна быть между 0 для первого элемента и arraySize - 1 для последнего элемента.

Отрицательное indexValue или значение больше или равное arraySize не допускается.

Смягчение

Устранение этой ошибки зависит от намерения:

  • Does the provided indexValue assume 1-based indexing?

    Используйте element_at(arrayExpr, indexValue), elt(arrayExpr, indexValue) или arrayExpr[indexValue - 1] для получения правильного элемента массива.

  • Является ли indexValue отрицательным, ожидающим получения элемента относительно конца массива?

    Используйте element_at(arrayExpr, indexValue) или elt(arrayExpr, indexValue)'. Adjust for 1-based indexing if necessary.

  • Вы ожидаете получить значение NULL, возвращаемое для элементов за пределами кратности индекса?

    If you can change the expression, use try_element_at(arrayExpr, indexValue + 1) to tolerate references out of bound. Note the 1-based indexing for try_element_at.

    If you cannot change the expression, as a last resort, temporarily set the ansiConfig to false to tolerate references out of bound.

Примеры

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