索引 <indexValue>
超出界限。 数组具有 <arraySize>
元素。 使用 SQL 函数 get()
容许访问无效索引上的元素,并改为返回 NULL。 如有必要,请将 <ansiConfig>
设置为“false”以绕过此错误。
- indexValue:数组中请求的索引。
- arraySize:数组的基数。
- ansiConfig:用于更改 ANSI 模式的配置设置。
与element_at和 elt 不同,对使用 arrayExpr[indexValue] 语法的数组的引用indexValue
必须介于第一个元素和arraySize - 1
最后一个元素之间0
。
不允许使用负 indexValue
或大于或等于 arraySize
的值。
此错误的缓解措施取决于意图:
提供的
indexValue
是否假定为基于 1 的索引?使用 element_at(arrayExpr、 indexValue)、 elt(arrayExpr、indexValue)'或 arrayExpr[indexValue - 1] 解析正确的数组元素。
indexValue
为负值时,是否期望从数组末尾开始检索元素?使用 element_at(arrayExpr, indexValue) 或 elt(arrayExpr, indexValue)。 如有必要,请调整为从 1 开始的索引。
是否希望为索引基数之外的元素返回一个
NULL
值?如果可以更改表达式,请使用 try_element_at(arrayExpr、indexValue + 1) 来容忍超出绑定的引用。 请注意
try_element_at
的从 1 开始的索引。如果无法更改表达式,作为最后的手段,请暂时将
ansiConfig
设置为false
以允许超出边界的引用。
-- 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;