다음을 통해 공유

INVALID_ARRAY_INDEX 오류 클래스

  • 아티클

SQLSTATE: 22003

인덱 <indexValue> 스가 범위를 벗어났습니다. 배열에는 요소가 있습니다 <arraySize> . SQL 함수 get() 를 사용하여 잘못된 인덱스에서 요소에 액세스하는 것을 허용하고 대신 NULL을 반환합니다. 필요한 경우 이 오류를 무시하려면 "false"로 설정합니다 <ansiConfig> .

매개 변수

  • indexValue: 배열에 요청된 인덱스입니다.
  • arraySize: 배열의 카디널리티입니다.
  • ansiConfig: ANSI 모드를 변경하는 구성 설정입니다.

설명

element_at 및 elt와 달리 arrayExpr[indexValue] 구문을 사용하는 배열에 대한 참조 indexValue 는 첫 번째 요소와 arraySize - 1 마지막 요소에 대해 사이 0 여야 합니다.

음수 indexValue 또는 보다 크거나 같은 arraySize 값은 허용되지 않습니다.

완화 방법

이 오류에 대한 완화는 의도에 따라 달라집니다.

  • 제공된 indexValue 가 1 기반 인덱싱을 가정하나요?

    element_at(arrayExpr, indexValue), elt(arrayExpr, indexValue)' 또는 arrayExpr[indexValue - 1]을 사용하여 올바른 배열 요소를 resolve.

  • 음수는 indexValue 배열의 끝을 기준으로 요소를 검색할 것으로 예상합니까?

    element_at(arrayExpr, indexValue) 또는 elt(arrayExpr, indexValue)'를 사용합니다. 필요한 경우 1 기반 인덱싱을 조정합니다.

  • 인덱스의 카디널리티 외부 요소에 대해 반환되는 값을 가져올 NULL 것으로 예상되나요?

    식을 변경할 수 있는 경우 try_element_at(arrayExpr, indexValue + 1) 을 사용하여 바인딩된 외부 참조를 허용합니다. 에 대한 1 기반 인덱싱을 확인합니다 try_element_at.

    식을 변경할 수 없는 경우 마지막 수단으로 일시적으로 를 로 설정 ansiConfigfalse 하여 참조가 바인딩되지 않도록 허용합니다.

예

-- An INVALID_ARRAY_INDEX error because of mismatched indexing
> SELECT array('a', 'b', 'c')[index] FROM VALUES(1), (3) AS T(index);
  [INVALID_ARRAY_INDEX] The index 3 is out of bounds. The array has 3 elements. If necessary set "ANSI_MODE" to false to bypass this error.

-- Using element_at instead for 1-based indexing
> SELECT element_at(array('a', 'b', 'c'), index) FROM VALUES(1), (3) AS T(index);
  a
  c

-- Adjusting the index to be 0-based
> SELECT array('a', 'b', 'c')[index -1] FROM VALUES(1), (3) AS T(index);

-- Tolerating out of bound array index with adjustment to 1-based indexing
> SELECT try_element_at(array('a', 'b', 'c'), index + 1) FROM VALUES(1), (3) AS T(index);
  b
  NULL

-- An INVALID_ARRAY_INDEX error because of negative index
> SELECT array('a', 'b', 'c')[index] FROM VALUES(-1), (2) AS T(index);
  [INVALID_ARRAY_INDEX] The index -1 is out of bounds. The array has 3 elements. If necessary set "ANSI_MODE" to "false" to bypass this error.

-- Using element_at to index relative to the end of the array
> SELECT element_at(array('a', 'b', 'c'), index) FROM VALUES(-1), (2) AS T(index);
  c
  b

-- Tolerating an out of bound index by setting ansiConfig in Databricks SQL
> SET ANSI_MODE = false;
> SELECT array('a', 'b', 'c')[index] FROM VALUES(1), (3) AS T(index);
  b
  NULL
> SET ANSI_MODE = true;

-- Tolerating an out of bound index by setting ansiConfig in Databricks Runtime
> SET spark.sql.ansi.enabled = false;
> SELECT array('a', 'b', 'c')[index] FROM VALUES(1), (3) AS T(index);
  b
  NULL
> SET spark.sql.ansi.enabled = true;