Fonction d’agrégation collect_list

  • Article

S’applique à :case marquée oui Databricks SQL case marquée oui Databricks Runtime

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

Syntaxe

collect_list ( [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 est spécifié, la fonction ne collecte que des valeurs uniques et est un synonyme de la fonction d’agrégation collect_set.

Exemples

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

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