Fonction d’agrégation array_agg

  • Article

S’applique à :coche marquée oui Databricks SQL oui coché 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 la fonction d’agrégation collect_list.

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