INVALID_ARRAY_INDEX classe de erro

SQLSTATE: 22003

O índice <indexValue> está fora dos limites. A matriz tem <arraySize> elementos. Use a função SQL get() para tolerar o acesso a um elemento em índice inválido e retornar NULL em vez disso. Se necessário, defina <ansiConfig> como "false" para ignorar esse erro.

Parâmetros

• indexValue: O índice solicitado na matriz.
• arraySize: A cardinalidade da matriz.
• ansiConfig: A definição de configuração para alterar o modo ANSI.

Explicação

Ao contrário element_at e elt, uma referência indexValue em uma matriz usando a sintaxe arrayExpr[indexValue] deve estar entre 0 para o primeiro elemento e arraySize - 1 para o último elemento.

Não é permitida uma indexValue negativa ou um valor maior ou igual a arraySize.

Atenuação

A atenuação deste erro depende da intenção:

• A indexValue fornecida assume uma indexação baseada em 1?

  Use element_at(arrayExpr, indexValue), elt(arrayExpr, indexValue)', ou arrayExpr[indexValue - 1] para resolver o elemento de matriz correto.

• O indexValue negativo espera aceder a um elemento relativo ao final do array?

  Use element_at(arrayExpr, indexValue) ou elt(arrayExpr, indexValue)'. Ajuste para indexação baseada em 1, se necessário.

• Você espera obter um valor NULL a ser retornado para elementos fora da cardinalidade do índice?

  Se conseguires alterar a expressão, usa try_element_at(arrayExpr, indexValue + 1) para tolerar referências fora dos limites. Observe a indexação baseada em 1 para try_element_at.

  Se não for possível alterar a expressão, como último recurso, defina temporariamente o ansiConfig como false para tolerar as referências fora do limite.

Exemplos

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

Relacionados

• operador [ ] (sinal de colchete)
• ANSI_MODE
• função element_at
• função ELT
• função try_element_at