INVALID_ARRAY_INDEX_IN_ELEMENT_AT エラー クラス
インデックス <indexValue>
が範囲外です。 配列には <arraySize>
要素があります。 try_element_at
を使用して、無効なインデックスで要素へのアクセスを許容し、代わりに NULL を返します。 このエラーをバイパスするには、必要に応じて <ansiConfig>
を "false" に設定します。
パラメーター
- indexValue: 配列に要求されたインデックス。
- arraySize: 配列のカーディナリティ。
- ansiConfig: ANSI モードを変更するための構成設定。
説明
indexValue
は、element_at (arrayExpr, indexValue)または elt(arrayExpr, indexValue) 式に対して定義された配列要素の境界を超えています。
値は、0
を除き、-arraySize
と arraySize
の間である必要があります。
緩和
このエラーの軽減策は、原因によって異なります。
配列のカーディナリティが予想よりも小さいか。
入力配列を修正し、クエリを再実行します。
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;