Share via

INVALID_ARRAY_INDEX_IN_ELEMENT_AT 错误类

  • 项目

SQLSTATE: 22003

索引 <indexValue> 超出界限。 数组具有 <arraySize> 个元素。 使用 try_element_at 容许访问无效索引上的元素，并返回 NULL。 如有必要，请将 <ansiConfig> 设置为“false”以绕过此错误。

参数

  • indexValue：数组中请求的索引。
  • arraySize：数组的基数。
  • ansiConfig：更改 ANSI 模式的配置设置。

说明

对于 element_at(arrayExpr, indexValue) 或 elt(arrayExpr, indexValue) 表达式，indexValue 超出了已定义数组元素的边界。

该值必须介于 -arraySize 和 arraySize 之间，不包括 0。

缓解

此错误的缓解方法取决于具体原因：

  • 数组的基数是否小于预期？

    修复输入数组并重新运行查询。

  • indexValue 是否计算错误？

    调整 indexValue 并重新运行查询。

  • 是否希望为索引基数之外的元素返回一个 NULL 值？

    如果可以更改表达式，请使用 try_element_at(arrayExpr, indexValue) 以允许超出边界的引用。

    如果无法更改表达式，作为最后的手段，请暂时将 ansiConfig 设置为 false 以允许超出边界的引用。

示例

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