Partage via

Classe d’erreur INVALID_ARRAY_INDEX

  • Article

SQLSTATE : 22003

L'index <indexValue> est hors limites. Le tableau comporte des éléments <arraySize>. Utilisez la fonction SQLget() pour tolérer l’accès à l’élément à un index non valide et retourner la valeur NULL à la place. Si nécessaire, définissez <ansiConfig> sur « false » pour contourner cette erreur.

Paramètres

  • indexValue: index demandé dans le tableau.
  • arraySize : cardinalité du tableau.
  • ansiConfig : paramètre de configuration pour modifier le mode ANSI.

Explication

Contrairement à element_at et elt, une référence indexValue dans un tableau à l’aide de la syntaxe arrayExpr[indexValue] doit être comprise entre 0 pour le premier élément et arraySize - 1 pour le dernier élément.

Une valeur négative indexValue ou égale à arraySize n’est pas autorisée.

Limitation des risques

La manière d’atténuer l’erreur dépendra de son intention :

  • Est-ce que indexValue fournie suppose-t-elle l’indexation basée sur 1 ?

    Utilisez element_at(arrayExpr, indexValue), elt(arrayExpr, indexValue)' ou arrayExpr[indexValue - 1] pour résoudre l’élément de tableau approprié.

  • Le indexValue négatif s’attend-il à récupérer l’élément par rapport à la fin du tableau ?

    Utilisez element_at(arrayExpr, indexValue) ou elt(arrayExpr, indexValue). Ajustez l’indexation basée sur 1 si nécessaire.

  • Prévoyez-vous de retourner une NULL valeur pour les éléments en dehors de la cardinalité de l’index ?

    Si vous pouvez modifier l’expression, utilisez try_element_at(arrayExpr, indexValue +1) pour tolérer les références hors de limite. Notez l’indexation basée sur 1 pour try_element_at.

    Si vous ne pouvez pas modifier l’expression, en dernier recours, définissez temporairement la valeur ansiConfig sur false pour tolérer les références hors limites.

Exemples

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