共用方式為

INVALID_ARRAY_INDEX_IN_ELEMENT_AT錯誤類別

  • 發行項

SQLSTATE：22003

索引 <indexValue> 超出界限。 陣列具有 <arraySize> 元素。 使用 try_element_at 可容許存取無效索引處的專案，並改為傳回 Null。 如有必要，請將 設定 <ansiConfig> 為 「false」 以略過此錯誤。

參數

  • indexValue：要求之索引到陣列中。
  • arraySize：陣列的基數。
  • ansiConfig：變更 ANSI 模式的組態設定。

解釋

indexValue 超出element_at (arrayExpr、indexValue) 或 elt (arrayExpr、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;