Fonction d’agrégation array_agg

S’applique à : Databricks SQL Databricks Runtime 10.4 LTS et versions ultérieures

Retourne un tableau composé de toutes les valeurs d’expr dans le groupe. Cette fonction est un synonyme de collect_list la fonction d’agrégation.

Syntaxe

array_agg ( [ALL | DISTINCT] expr ) [FILTER ( WHERE cond ) ]

Cette fonction peut également être appelée en tant que fonction de fenêtre à l’aide de la clause OVER.

Arguments

• expr : Expression de tout type.
• cond : expression booléenne facultative qui filtre les lignes utilisées pour l’agrégation.

Retours

Tableau (ARRAY) du type d’argument.

L’ordre des éléments du tableau n’est pas déterministe. Les valeurs NULL sont exclues.

Si DISTINCT elle est spécifiée, la fonction collecte uniquement des valeurs uniques et est un synonyme de collect_set la fonction d’agrégation.

Exemples

> SELECT array_agg(col) FROM VALUES (1), (2), (NULL), (1) AS tab(col);
 [1,2,1]
> SELECT array_agg(DISTINCT col) FROM VALUES (1), (2), (NULL), (1) AS tab(col);
 [1,2]

Fonctions connexes

• Fonction array
• collect_list fonction d’agrégation
• collect_set fonction d’agrégation
• Fonctions Windows