Skip to main content
Ces paramètres sont disponibles dans system.settings et sont générés automatiquement à partir du source.

​
group_by_overflow_mode

Définit le comportement lorsque le nombre de clés uniques pour l’agrégation dépasse la limite :
  • throw : lever une exception
  • break : arrêter l’exécution de la requête et renvoyer un résultat partiel
  • any : poursuivre l’agrégation pour les clés déjà présentes dans l’ensemble, sans y ajouter de nouvelles clés.
L’utilisation de la valeur ‘any’ permet d’exécuter une approximation de GROUP BY. La qualité de cette approximation dépend de la nature statistique des données.

​
group_by_top_k_optimization_observation_rows

Pour enable_group_by_top_k_optimization : nombre de lignes que chaque flux d’agrégation observe avant de figer un tas top-K plein qui a ignoré moins de 10 % des lignes en entrée et évincé moins de clés que sa capacité. Un tas figé signifie que l’agrégation se poursuit comme si l’optimisation était désactivée. La fenêtre effective est au moins égale à deux fois la taille réservée du tas, afin qu’il ait toujours la possibilité de se remplir avant d’être évalué. 0 désactive ce gel (le tas est néanmoins figé lorsqu’un ensemble d’égalités à la limite devient trop grand). Cela n’a aucun effet sur les requêtes GROUP BY keys LIMIT K sans ORDER BY, pour lesquelles le gel est toujours désactivé : le plan associé à cette forme contient un tri synthétisé qui n’est rentable que tant que le tas limite la taille de la table de hachage ; figer le tas produirait donc un plan plus lent que celui sans optimisation.

​
group_by_two_level_threshold

Nombre de clés à partir duquel une agrégation à deux niveaux démarre. 0 - le seuil n’est pas défini.

​
group_by_two_level_threshold_bytes

Taille en octets de l’état d’agrégation à partir de laquelle une agrégation à deux niveaux commence à être utilisée. 0 : le seuil n’est pas défini. L’agrégation à deux niveaux est utilisée lorsqu’au moins l’un des seuils est atteint.

​
group_by_use_nulls

Modifie la façon dont la clause GROUP BY traite les types des clés d’agrégation. Lorsque les spécificateurs ROLLUP, CUBE ou GROUPING SETS sont utilisés, certaines clés d’agrégation peuvent ne pas servir à produire certaines lignes de résultat. Les colonnes correspondant à ces clés sont renseignées soit avec la valeur par défaut, soit avec NULL dans les lignes correspondantes, selon ce paramètre. Valeurs possibles :
  • 0 — La valeur par défaut du type de clé d’agrégation est utilisée pour produire les valeurs manquantes.
  • 1 — ClickHouse exécute GROUP BY conformément à la norme SQL. Les types des clés d’agrégation sont convertis en Nullable. Les colonnes correspondant à ces clés d’agrégation sont renseignées avec NULL pour les lignes qui ne les utilisent pas.
Voir aussi :
Dernière modification le 26 août 2026