Passer au contenu principal

groupArray

Introduit dans : v1.1.0 Crée un tableau de valeurs d’argument. Les valeurs peuvent être ajoutées au tableau dans un ordre quelconque (indéterminé). La deuxième version (avec le paramètre max_size) limite la taille du tableau résultant à max_size éléments. Par exemple, groupArray(1)(x) est équivalent à [any(x)]. Dans certains cas, vous pouvez néanmoins vous fier à l’ordre d’exécution. Cela s’applique lorsque SELECT provient d’une sous-requête qui utilise ORDER BY, si le résultat de la sous-requête est suffisamment petit. La fonction groupArray supprime les valeurs NULL du résultat. Syntaxe
groupArray(x)
groupArray(max_size)(x)
Alias : array_agg Paramètres
  • max_size — Facultatif. Limite la taille du tableau résultant à max_size éléments. UInt64
Arguments
  • x — Valeurs d’argument à regrouper dans un tableau. Any
Valeur renvoyée Renvoie un tableau contenant les valeurs d’argument. Array Exemples Utilisation de base
Query
SELECT id, groupArray(10)(name) FROM default.ck GROUP BY id;
Response
┌─id─┬─groupArray(10)(name)─┐
│  1 │ ['zhangsan','lisi']  │
│  2 │ ['wangwu']           │
└────┴──────────────────────┘
Dernière modification le 25 juin 2026