Compartir a través de

Clase de error INVALID_ARRAY_INDEX_IN_ELEMENT_AT

  • Artículo

SQLSTATE: 22003

El índice está <indexValue> fuera de los límites. La matriz tiene <arraySize> elementos. Use try_element_at para tolerar el acceso al elemento en un índice no válido y devolver NULL en su lugar. Si es necesario, establezca <ansiConfig> en "false" para omitir este error.

Parámetros

  • indexValue: el índice solicitado en la matriz.
  • arraySize: la cardinalidad de la matriz.
  • ansiConfig: el valor de configuración para modificar el modo ANSI.

Explicación

indexValueestá fuera del límite de los elementos de matriz definidos para una expresión element_at(arrayExpr, indexValue) o elt(arrayExpr, indexValue).

El valor debe estar entre -arraySize y arraySize, excepto 0.

Mitigación

La mitigación de este error depende de la causa:

  • ¿La cardinalidad de la matriz es menor de lo esperado?

    Corrija la matriz de entrada y vuelva a ejecutar la consulta.

  • ¿Se ha calculado indexValue incorrectamente?

    Ajuste indexValue y vuelva a ejecutar la consulta.

  • ¿Espera obtener un valor NULL que se va a devolver para los elementos fuera de la cardinalidad del índice?

    Si puede cambiar la expresión, use try_element_at(arrayExpr, indexValue) para tolerar referencias fuera del límite.

    Si no puede cambiar la expresión, como último recurso, establezca temporalmente ansiConfig en false para tolerar las referencias fuera del límite.

Ejemplos

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