INVALID_ARRAY_INDEX_IN_ELEMENT_AT felklass

  • Artikel

SQLSTATE: 22003

Indexet <indexValue> ligger utanför gränserna. Matrisen har <arraySize> element. Använd try_element_at för att tolerera åtkomst av element vid ogiltigt index och returnera NULL i stället. Om det behövs anger du <ansiConfig> "false" för att kringgå det här felet.

Parametrar

  • indexValue: Det begärda indexet i matrisen.
  • arraySize: Matrisens kardinalitet.
  • ansiConfig: Konfigurationsinställningen för att ändra ANSI-läge.

Förklaring

indexValueligger utanför gränsen för definierade matriselement för ett uttryck av typen element_at(arrayExpr, indexValue)eller elt(arrayExpr, indexValue).

Värdet måste vara mellan -arraySize och arraySize, exklusive 0.

Lindring

Riskreduceringen för det här felet beror på orsaken:

  • Är matrisens kardinalitet mindre än förväntat?

    Åtgärda indatamatrisen och kör frågan igen.

  • Har indexValue beräknats felaktigt?

    Justera indexValue och kör frågan igen.

  • Förväntar du dig att ett NULL värde returneras för element utanför indexets kardinalitet?

    Om du kan ändra uttrycket använder du try_element_at(arrayExpr, indexValue) för att tolerera referenser utanför gränsen.

    Om du inte kan ändra uttrycket, som en sista utväg, ställer du tillfälligt in ansiConfig till för false att tolerera referenser utanför gränsen.

Exempel

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