Aracılığıyla paylaş

INVALID_ARRAY_INDEX hata koşulu

SQLSTATE: 22003

Dizin <indexValue> sınırların dışına çıktı. Dizinin <arraySize> öğeleri vardır. Geçersiz dizinde öğeye erişimi tolere etmek ve bunun yerine NULL döndürmek için SQL işlevini get() kullanın. Gerekirse bu hatayı atlamak için <ansiConfig> "false" olarak ayarlayın.

Parametreler

  • indexValue: dizideki istenen indeks.
  • arraySize: Dizinin kardinalitesi.
  • ansiConfig: ANSI modunu değiştirmek için yapılandırma ayarı.

Açıklama

element_at ve elt'ten farklı olarak, indexValue söz dizimini kullanan bir diziye yapılan başvuru, ilk öğe ile son öğe arasında 0 olmalıdır.

Negatif indexValue veya arraySize'a eşit veya daha büyük bir değere izin verilmez.

Azaltma

Bu hatanın hafifletilmesi niyete bağlıdır.

  • Sağlanan indexValue , 1 tabanlı dizin oluşturmayı varsayar mı?

    Doğru dizi öğesini çözümlemek için element_at(arrayExpr, indexValue), elt(arrayExpr, indexValue)veya arrayExpr[indexValue - 1] kullanın.

  • Negatif değer, indexValue dizinin sonundan itibaren bir öğe alınmasını bekliyor mu?

    element_at(arrayExpr, indexValue) veya elt(arrayExpr, indexValue)kullanın. Gerekirse 1 tabanlı dizin oluşturma için ayarlayın.

  • Dizinin kardinalitesinin dışındaki öğeler için döndürülecek bir NULL değeri almayı bekliyor musunuz?

    İfadeyi değiştirebiliyorsanız, referansların sınırları aşmasını tolere etmek için try_element_at(arrayExpr, indexValue + 1) kullanın. try_element_atiçin 1 tabanlı dizin oluşturmayı not edin.

    İfadeyi değiştiremiyorsanız, son çare olarak, sınırların dışındaki referansları tolere etmek için geçici olarak ansiConfig'ı false olarak ayarlayın.

Örnekler

-- 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;
  • Last updated on