Sdílet prostřednictvím


INVALID_ARRAY_INDEX_IN_ELEMENT_AT třída chyby

SQLSTATE: 22003

Index <indexValue> je mimo rozsah. Pole obsahuje <arraySize> prvky. Slouží try_element_at k tolerování přístupu k elementu při neplatném indexu a vrácení hodnoty NULL místo toho. Pokud je to nutné, nastavte <ansiConfig> hodnotu false, aby se tato chyba vynechala.

Parametry

  • indexValue: Požadovaný index do pole.
  • arraySize: Kardinalita pole.
  • ansiConfig: Nastavení konfigurace pro změnu režimu ANSI.

Vysvětlení

indexValueje za hranicí definovaných prvků pole pro výraz element_at(arrayExpr, indexValue) nebo elt(arrayExpr, indexValue).

Hodnota musí být v rozsahu a -arraySize s arraySizevýjimkou 0.

Zmírnění

Zmírnění této chyby závisí na příčině:

  • Je kardinalita pole menší, než se čekalo?

    Opravte vstupní pole a spusťte dotaz znovu.

  • Došlo indexValue k nesprávnému výpočtu?

    Upravte indexValue dotaz a spusťte ho znovu.

  • Očekáváte, že získáte hodnotu, která NULL se vrátí pro prvky mimo kardinalitu indexu?

    Pokud můžete změnit výraz, použijte try_element_at(arrayExpr, indexValue) k tolerování odkazů mimo vazbu.

    Pokud nemůžete výraz změnit, jako poslední možnost, dočasně nastavte ansiConfig na , false aby se odkazy netoleroval mimo hranici.

Příklady

-- 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;