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

класс ошибок 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 ли индексирование на основе 1?

    Используйте 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;