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

класс ошибок INVALID_ARRAY_INDEX

  • Статья

SQLSTATE: 22003

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

Parameters

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

Объяснение

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

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

Смягчение

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

  • Предполагается ли индексирование на основе 1 в предоставленной indexValue?

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

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

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

  • Ожидаете ли вы get возврат NULL значения для элементов за пределами кратности индекса?

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

    Если вы не можете изменить выражение, в крайнем случае временно setansiConfig на 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;