klasa błędów INVALID_ARRAY_INDEX
Indeks <indexValue> jest poza granicami. Tablica zawiera <arraySize> elementy. Użyj funkcji get() SQL, aby tolerować dostęp do elementu w nieprawidłowym indeksie i zwracać wartość NULL. W razie potrzeby 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
W przeciwieństwie do element_at i elt odwołanie indexValue do tablicy używającej składni arrayExpr[indexValue] musi znajdować się między 0 pierwszym elementem a arraySize - 1 ostatnim elementem.
Wartość ujemna indexValue lub większa lub równa jest arraySize niedozwolona.
Łagodzenia
Ograniczenie ryzyka dla tego błędu zależy od intencji:
Czy w podanym
indexValuezadaniu przyjęto założenie, że indeksowanie oparte na 1Użyj element_at(arrayExpr, indexValue), elt(arrayExpr, indexValue)' lub arrayExpr[indexValue - 1], aby rozwiązać problem z poprawnym elementem tablicy.
Czy ujemne oczekiwano
indexValuepobrania elementu względem końca tablicy?Użyj element_at(arrayExpr, indexValue) lub elt(arrayExpr, indexValue)". W razie potrzeby dostosuj indeksowanie oparte na 1.
Czy oczekujesz, że zostanie zwrócona
NULLwartość dla elementów spoza kardynalności indeksu?Jeśli możesz zmienić wyrażenie, użyj funkcji try_element_at(arrayExpr, indexValue + 1), aby tolerować odwołania poza granicą. Zanotuj indeksowanie oparte na 1 dla .
try_element_atJeśli nie możesz zmienić wyrażenia, w ostateczności tymczasowo ustaw
ansiConfigwartość , abyfalsetolerować odwołania poza granicą.
Przykłady
-- 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;