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;