Opérateur [ ] (signe crochets)

S’applique à : Databricks SQL Databricks Runtime

Retourne un élément de tableau ou une valeur de mappage en fonction d’un index ou d’une clé.

Syntaxe

expr [ keyExpr ]

Notez que l’utilisation de crochets ici est comme texte littéral et n’indique pas une syntaxe facultative.

Arguments

• expr : Expression ARRAY ou MAP.
• keyExpr : si expr est un tableau (ARRAY), numérique intégral. Sinon, expression correspondant au type de la clé du mappage (MAP).

Retours

Le type de résultat est le type d’élément du tableau (ARRAY) ou le type de valeur du mappage (MAP).

Le premier élément d’un tableau (ARRAY) est à l’index 0.

Si le keyExpr n’est pas une clé valide pour map expr Azure Databricks retourne null.

Si la keyExpr n’est pas liée à l’erreur ARRAY expr, Azure Databricks déclenche une erreur INVALID_ARRAY_INDEX.

Notes

Dans Databricks Runtime, si spark.sql.ansi.enabled a pour valeur false, l’opérateur retourne NULL à la place d’une erreur « hors limites ».

Conditions d’erreur courantes

• INVALID_ARRAY_INDEX

Exemples

> SELECT a[2] FROM VALUES(array(10, 20, 30)) AS T(a);
  30

> SELECT m[1] FROM VALUES(map(1, 'Hello', 2, 'World')) AS T(m);
  Hello

> SELECT array(1, 2, 3)[5];
  Error: INVALID_ARRAY_INDEX

Fonctions connexes

• Fonction array
• Fonction array_contains
• Fonction array_position
• Fonction map
• Fonction map_keys
• Fonction map_values