> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-vortex-format.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# paramètres de session group_by_*
> Paramètres de session ClickHouse du groupe généré group_by_*.
export const ExperimentalBadge = () => {
return
Fonctionnalité expérimentale
;
};
export const VersionHistory = ({rows = []}) => {
if (rows.length === 0) {
return null;
}
const headers = ["Version", "Valeur par défaut", "Commentaire"];
const border = "1px solid rgba(128, 128, 128, 0.3)";
const cell = {
border,
padding: "0.25rem 0.5rem",
textAlign: "start",
verticalAlign: "top"
};
return
Historique des versions
{headers.map(header => |
{header}
| )}
{rows.map((row, row_index) =>
{(row.items ?? []).map((item, item_index) => |
{item?.label}
| )}
)}
;
};
export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
return
Type
{type}
Par défaut
{default_value}
{changeable_without_restart &&
Modifiable sans redémarrage
}
{changeable_without_restart &&
{changeable_without_restart}
}
;
};
Ces paramètres sont disponibles dans [system.settings](/fr/reference/system-tables/settings) et sont générés automatiquement à partir du [source](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).
## 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](/fr/reference/statements/select/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](/fr/reference/data-types/nullable). Les colonnes correspondant à ces clés d’agrégation sont renseignées avec [NULL](/fr/reference/syntax#null) pour les lignes qui ne les utilisent pas.
Voir aussi :
* [clause GROUP BY](/fr/reference/statements/select/group-by)