Udostępnij za pośrednictwem

INVALID_ARRAY_INDEX_IN_ELEMENT_AT, klasa błędów

  • Artykuł

SQLSTATE: 22003

Indeks <indexValue> jest poza granicami. Tablica zawiera <arraySize> elementy. Służy try_element_at do tolerowania dostępu do elementu w nieprawidłowym indeksie i zwracania wartości NULL. Jeśli to konieczne, ustaw <ansiConfig> wartość "false", aby pominąć ten błąd.

Parametry

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

Wyjaśnienie

indexValuewykracza poza granicę zdefiniowanych elementów tablicy dla wyrażenia element_at(arrayExpr, indexValue)lub elt(arrayExpr, indexValue).

Wartość musi zawierać się między -arraySize i arraySize, z wyjątkiem 0.

Łagodzenia

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

  • Czy kardynalność tablicy jest mniejsza niż oczekiwano?

    Napraw tablicę wejściową i uruchom ponownie zapytanie.

  • Został indexValue obliczony niepoprawnie?

    Dostosuj indexValue i uruchom ponownie zapytanie.

  • Czy oczekujesz, że NULL zostanie zwrócona wartość dla elementów spoza kardynalności indeksu?

    Jeśli możesz zmienić wyrażenie, użyj try_element_at(arrayExpr, indexValue), aby tolerować odwołania poza granicą.

    Jeśli nie możesz zmienić wyrażenia w ostateczności, tymczasowo ustaw wartość ansiConfig na false tolerowanie odwołań poza granicą.

Przykłady

-- An INVALID_ARRAY_INDEX_IN_ELEMENT_AT error because of mismatched indexing
> SELECT element_at(array('a', 'b', 'c'), index) FROM VALUES(1), (4) AS T(index);
  [INVALID_ARRAY_INDEX_IN_ELEMENT_AT] The index 4 is out of bounds. The array has 3 elements. If necessary set "ANSI_MODE" to false to bypass this error.

-- Increase the aray size to cover the index
> SELECT element_at(array('a', 'b', 'c', 'd'), index) FROM VALUES(1), (4) AS T(index);
  a
  d

-- Adjusting the index to match the array
> SELECT element_at(array('a', 'b', 'c'), index) FROM VALUES(1), (3) AS T(index);
  a
  c

-- Tolerating out of bound array index with adjustment to 1-based indexing
> SELECT try_element_at(array('a', 'b', 'c'), index) FROM VALUES(1), (4) AS T(index);
  a
  NULL

-- Tolerating out of bound by setting ansiConfig in Databricks SQL
> SET ANSI_MODE = false;
> SELECT element_at(array('a', 'b', 'c'), index) FROM VALUES(1), (4) AS T(index);
  a
  NULL
> SET ANSI_MODE = true;

-- Tolerating out of bound by setting ansiConfig in Databricks Runtime
> SET spark.sql.ansi.enabled = false;
> SELECT element_at(array('a', 'b', 'c'), index) FROM VALUES(1), (4) AS T(index);
  a
  NULL
> SET spark.sql.ansi.enabled = true;