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

условие ошибки "INVALID_ARRAY_INDEX"

SQLSTATE: 22003

Индекс <indexValue> находится вне допустимого диапазона. Массив содержит элементы <arraySize>. Используйте функцию get() SQL, чтобы допускать доступ к элементу с недопустимым индексом и возвращать значение NULL. Если необходимо, установите <ansiConfig> на "false", чтобы обойти эту ошибку.

Параметры

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

Объяснение

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

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

Смягчение

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

  • indexValue

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

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

    Используйте element_at(arrayExpr, indexValue) или elt(arrayExpr, indexValue)'. При необходимости настройте индексирование на основе 1.

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

    Если можно изменить выражение, используйте try_element_at(arrayExpr, indexValue + 1) для допуска ссылок вне границы. Обратите внимание на индексирование, начинающееся с 1.try_element_at

    Если вы не можете изменить выражение, в крайнем случае временно установите ansiConfig на false, чтобы допустить ссылки вне границ.

Примеры

-- 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;
  • Last updated on