Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
L'indice <indexValue> è fuori dai limiti. La matrice include elementi <arraySize>. Usare la funzione SQL get() per tollerare l'accesso all'elemento in corrispondenza dell'indice non valido e restituire invece NULL. Se necessario, impostare <ansiConfig> su "false" per ignorare questo errore.
Parameters
- indexValue: indice richiesto nella matrice.
- arraySize: cardinalità della matrice.
- ansiConfig: impostazione di configurazione per modificare la modalità ANSI.
Spiegazione
A differenza di element_at e elt, un riferimento indexValue in una matrice che usa la sintassi arrayExpr[indexValue] deve essere tra 0 per il primo elemento e arraySize - 1 per l'ultimo elemento.
Non è consentito un indexValue negativo o un valore maggiore o uguale a arraySize.
Mitigazione
La mitigazione per questo errore dipende dalla finalità:
L'oggetto fornito
indexValuepresuppone l'indicizzazione basata su 1?Usare element_at(arrayExpr, indexValue), elt(arrayExpr, indexValue)', o arrayExpr[indexValue - 1] per risolvere l'elemento di matrice corretto.
Il valore negativo si aspetta di recuperare l'elemento
indexValuerispetto alla fine dell'array?Usare element_at(arrayExpr, indexValue) o elt(arrayExpr, indexValue)'. Adattare per l'indicizzazione basata sull'indice 1, se necessario.
Si prevede di ottenere un valore
NULLda restituire per gli elementi al di fuori della cardinalità dell'indice?Se è possibile modificare l'espressione, utilizzare try_element_at(arrayExpr, indexValue + 1) per tollerare riferimenti fuori dai limiti. Si noti l'indicizzazione basata su 1 per
try_element_at.Se non è possibile modificare l'espressione, come ultima risorsa, impostare temporaneamente il
ansiConfigsufalseper tollerare riferimenti fuori limite.
Examples
-- 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;