INVALID_ARRAY_INDEX錯誤類別
索引 <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) 來容許超出界限的參考。 請注意 的 1 型索引
try_element_at。如果您無法將運算式變更為最後一個方式，請暫時將 設定
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;