classe di errore INVALID_ARRAY_INDEX

SQLSTATE: 22003

L'indice <indexValue> non è compreso nei limiti. La matrice contiene <arraySize> elementi. Usare la funzione get() SQL per tollerare l'accesso all'elemento in corrispondenza dell'indice non valido e restituire invece NULL. Se necessario, impostare su <ansiConfig> "false" per ignorare questo errore.

Parametri

• indexValue: indice richiesto nella matrice.
• arraySize: cardinalità della matrice.
• ansiConfig: impostazione di configurazione per modificare la modalità ANSI.

Spiegazione

A differenza di element_at ed elt, un riferimento indexValue in una matrice che usa la sintassi arrayExpr[indexValue] deve essere compreso tra 0 il primo elemento e arraySize - 1 l'ultimo elemento.

Non è consentito un valore negativo indexValue o un valore maggiore o uguale a arraySize .

Mitigazione

La mitigazione per questo errore dipende dalla finalità:

• L'oggetto fornito indexValue presuppone l'indicizzazione basata su 1?

  Usare element_at(arrayExpr, indexValue),elt(arrayExpr, indexValue)', o arrayExpr[indexValue - 1] per risolvere l'elemento di matrice corretto.

• L'elemento negativo previsto per recuperare l'elemento indexValue rispetto alla fine della matrice?

  Usare element_at(arrayExpr, indexValue) o elt(arrayExpr, indexValue)'. Se necessario, regolare per l'indicizzazione basata su 1.

• Si prevede di ottenere un NULL valore da restituire per gli elementi esterni alla cardinalità dell'indice?

  Se è possibile modificare l'espressione, usare try_element_at(arrayExpr, indexValue + 1) per tollerare riferimenti non associati. Si noti l'indicizzazione basata su 1 per try_element_at.

  Se non è possibile modificare l'espressione, come ultima risorsa, impostare temporaneamente su ansiConfig per false tollerare riferimenti non associati.

Esempi

-- 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;

Correlati

• Operatore [ ] (segno tra parentesi)
• ANSI_MODE
• funzione element_at
• funzione elt
• funzione try_element_at