> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# paramètres de session max_bytes_*

> Paramètres de session ClickHouse du groupe généré max_bytes_*.

export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
  return <div className="not-prose" style={{
    display: "flex",
    flexWrap: "wrap",
    alignItems: "baseline",
    columnGap: "0.5rem",
    rowGap: "0.125rem",
    margin: "0.375rem 0",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <div style={{
    fontWeight: 600,
    opacity: 0.72
  }}>Type</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{type}</div>
      <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>Par défaut</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{default_value}</div>
      {changeable_without_restart && <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>
          Modifiable sans redémarrage
        </div>}
      {changeable_without_restart && <div style={{
    overflowWrap: "anywhere"
  }}>
          {changeable_without_restart}
        </div>}
    </div>;
};

Ces paramètres sont disponibles dans [system.settings](/docs/fr/reference/system-tables/settings) et sont générés automatiquement à partir du [code source](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).

<div id="max_bytes_before_external_group_by">
  ## max\_bytes\_before\_external\_group\_by
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

Valeur par défaut dans Cloud : la moitié de la quantité de mémoire de chaque réplique.

Active ou désactive l'exécution des clauses `GROUP BY` en mémoire externe.
(Voir [GROUP BY en mémoire externe](/docs/fr/reference/statements/select/group-by#group-by-in-external-memory))

Valeurs possibles :

* Volume maximal de RAM (en octets) pouvant être utilisé par une seule opération [GROUP BY](/docs/fr/reference/statements/select/group-by).
* `0` — `GROUP BY` en mémoire externe désactivé.

<Note>
  Si l'utilisation de la mémoire pendant les opérations GROUP BY dépasse ce seuil en octets,
  le mode « agrégation externe » est activé (écriture des données sur disque).

  La valeur recommandée est la moitié de la mémoire système disponible.
</Note>

<div id="max_bytes_before_external_join">
  ## max\_bytes\_before\_external\_join
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.4"},{"label": "0"},{"label": "Nouveau paramètre permettant de contrôler le déversement sur disque automatique des hash joins sur disque. Une valeur non nulle active le déversement sur disque et définit le seuil en octets."}]}]} />

S'il est défini sur une valeur non nulle et que `join_algorithm` vaut `hash`, `parallel_hash`, `default` ou `auto`, le hash join sera automatiquement converti en grace hash join pour permettre le déversement sur disque sur disque lorsque les données de droite dépassent ce nombre d'octets. Lorsqu'il est défini sur 0 (valeur par défaut), ce seuil absolu en octets est désactivé, mais un déversement sur disque automatique peut toujours se produire via `max_bytes_ratio_before_external_join` (qui vaut par défaut `0.5`) ; définissez les deux sur `0` pour désactiver complètement le déversement sur disque automatique. Cela empêche l'optimisation de lecture `read in order` via join.

<div id="max_bytes_before_external_sort">
  ## max\_bytes\_before\_external\_sort
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

Valeur par défaut dans Cloud : la moitié de la mémoire par réplique.

Active ou désactive l’exécution des clauses `ORDER BY` en mémoire externe. Voir [Détails d’implémentation de ORDER BY](/docs/fr/reference/statements/select/order-by#implementation-details)
Si l’utilisation de la mémoire pendant l’opération `ORDER BY` dépasse ce seuil en octets, le mode de « tri externe » (écriture des données sur disque) est activé.

Valeurs possibles :

* Volume maximal de RAM (en octets) pouvant être utilisé par une seule opération [ORDER BY](/docs/fr/reference/statements/select/order-by).
  La valeur recommandée est la moitié de la mémoire système disponible
* `0` — `ORDER BY` en mémoire externe désactivé.

<div id="max_bytes_before_remerge_sort">
  ## max\_bytes\_before\_remerge\_sort
</div>

<SettingsInfoBlock type="UInt64" default_value="1000000000" />

Dans le cas d’un ORDER BY avec LIMIT, lorsque l’utilisation de la mémoire dépasse le seuil spécifié, effectuez des étapes supplémentaires de fusion de blocs avant la fusion finale afin de ne conserver que les LIMIT premières lignes.

<div id="max_bytes_for_lazy_final">
  ## max\_bytes\_for\_lazy\_final
</div>

<SettingsInfoBlock type="UInt64" default_value="256000000" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.4"},{"label": "256000000"},{"label": "Nouveau paramètre définissant le nombre maximal d’octets dans l’ensemble utilisé pour l’optimisation lazy FINAL"}]}]} />

Nombre maximal d’octets dans l’ensemble utilisé pour l’optimisation lazy FINAL. Au-delà de cette limite, le système revient à FINAL standard.

<div id="max_bytes_in_distinct">
  ## max\_bytes\_in\_distinct
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

Nombre maximal d’octets de l’état (en octets non compressés) en mémoire,
utilisé par une table de hachage avec DISTINCT.

<div id="max_bytes_in_join">
  ## max\_bytes\_in\_join
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

La taille maximale, en octets, de la structure de données située du côté droit (généralement une table de hachage) utilisée lors de la jointure de tables.

Ce paramètre s’applique aux opérations [SELECT ... JOIN](/docs/fr/reference/statements/select/join) et au [moteur de table Join](/docs/fr/reference/engines/table-engines/special/join).

Si une requête contient plusieurs jointures, ClickHouse vérifie ce paramètre pour chaque résultat intermédiaire. Lorsque la limite est atteinte, l’action dépend de la valeur choisie pour [`join_algorithm`](/docs/fr/reference/settings/session-settings/join#join_algorithm) — consultez ce paramètre pour connaître le comportement propre à chaque algorithme (spill, repartitionnement, basculement ou throw/break selon [`join_overflow_mode`](/docs/fr/reference/settings/session-settings/join#join_overflow_mode)).

Valeurs possibles :

* Entier positif.
* 0 — Le contrôle de la mémoire est désactivé.

<div id="max_bytes_in_set">
  ## max\_bytes\_in\_set
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

Le nombre maximal d’octets (de données non compressées) qu’un ensemble dans la clause IN
créé à partir d’une sous-requête peut utiliser.

<div id="max_bytes_ratio_before_external_group_by">
  ## max\_bytes\_ratio\_before\_external\_group\_by
</div>

<SettingsInfoBlock type="Double" default_value="0.5" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "0.5"},{"label": "Le déversement automatique sur disque est activé par défaut."}]}, {"id": "row-2","items": [{"label": "24.12"},{"label": "0"},{"label": "Nouveau paramètre."}]}]} />

La proportion de mémoire disponible pouvant être utilisée par `GROUP BY`. Une fois ce seuil atteint,
la mémoire externe est utilisée pour l’agrégation.

Par exemple, si cette valeur est définie sur `0.6`, `GROUP BY` pourra utiliser 60 % de la mémoire disponible
(pour server/user/merges) au début de l’exécution ; ensuite, il
commencera à utiliser l’agrégation externe.

<div id="max_bytes_ratio_before_external_join">
  ## max\_bytes\_ratio\_before\_external\_join
</div>

<SettingsInfoBlock type="Double" default_value="0.5" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.5"},{"label": "0.5"},{"label": "Nouveau paramètre : ratio de mémoire disponible utilisé comme seuil de déversement sur disque pour les hash joins. Activé par défaut à `0.5`, à l'image de `max_bytes_ratio_before_external_group_by` et `max_bytes_ratio_before_external_sort`. Combiné avec la valeur absolue `max_bytes_before_external_join` (la plus petite des deux s'applique)."}]}]} />

Ratio de mémoire disponible autorisé pour `JOIN`. Une fois ce seuil atteint, le hash join est converti en grace hash join afin de déverser les données du côté droit sur disque.

Par exemple, si cette valeur est définie sur `0.6`, `JOIN` autorise l'utilisation de `60%` de la mémoire disponible (pour le serveur/l'utilisateur/les fusions) pour la table de hachage du côté droit au début de l'exécution ; au-delà, le déversement sur disque commence.

Si `max_bytes_before_external_join` et `max_bytes_ratio_before_external_join` sont tous deux définis, c'est le plus petit seuil obtenu qui est utilisé. Si le ratio vaut `0`, seule la valeur absolue s'applique.

N'a d'effet que lorsque `join_algorithm` vaut `hash`, `parallel_hash`, `default` ou `auto` et qu'un chemin de données temporaire est configuré.

<div id="max_bytes_ratio_before_external_sort">
  ## max\_bytes\_ratio\_before\_external\_sort
</div>

<SettingsInfoBlock type="Double" default_value="0.5" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "0.5"},{"label": "Activer par défaut le déversement sur disque automatique."}]}, {"id": "row-2","items": [{"label": "24.12"},{"label": "0"},{"label": "Nouveau paramètre."}]}]} />

Rapport de la mémoire disponible pouvant être utilisé pour `ORDER BY`. Une fois cette limite atteinte, le tri externe est utilisé.

Par exemple, s'il est défini sur `0.6`, `ORDER BY` pourra utiliser `60%` de la mémoire disponible (pour server/user/merges) au début de l'exécution, puis il commencera à utiliser le tri externe.

Notez que `max_bytes_before_external_sort` reste pris en compte : le déversement sur disque n'a lieu que si le bloc de tri est plus grand que `max_bytes_before_external_sort`.

<div id="max_bytes_to_read">
  ## max\_bytes\_to\_read
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

Le nombre maximal d’octets (de données non compressées) pouvant être lus à partir d’une table lors de l’exécution d’une requête.
La restriction est vérifiée pour chaque fragment de données traité, s’applique uniquement à
l’expression de table la plus imbriquée et, lors d’une lecture depuis un serveur distant, elle est vérifiée uniquement sur
le serveur distant.

<div id="max_bytes_to_read_leaf">
  ## max\_bytes\_to\_read\_leaf
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

Le nombre maximal d’octets (de données non compressées) pouvant être lus à partir d’une
table locale sur un nœud feuille lors de l’exécution d’une requête distribuée. Bien que les requêtes distribuées
puissent envoyer plusieurs sous-requêtes à chaque shard (feuille), cette limite
n’est vérifiée qu’à l’étape de lecture sur les nœuds feuille et est ignorée lors de
l’étape de fusion des résultats sur le nœud racine.

Par exemple, un cluster se compose de 2 shards et chaque shard contient une table avec
100 octets de données. Une requête distribuée censée lire toutes les données
des deux tables avec le paramètre `max_bytes_to_read=150` échouera, car le total
sera de 200 octets. Une requête avec `max_bytes_to_read_leaf=150` réussira puisque les
nœuds feuille liront au maximum 100 octets.

La restriction est vérifiée pour chaque fragment de données traité.

<Note>
  Ce paramètre est instable avec `prefer_localhost_replica=1`.
</Note>

<div id="max_bytes_to_sort">
  ## max\_bytes\_to\_sort
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

Le nombre maximal d’octets avant le tri. Si l’opération ORDER BY doit traiter
plus d’octets non compressés que la quantité spécifiée, le comportement sera
déterminé par `sort_overflow_mode`, qui est défini par défaut sur `throw`.

<div id="max_bytes_to_transfer">
  ## max\_bytes\_to\_transfer
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

Le nombre maximal d’octets (données non compressées) pouvant être transmis à un
serveur distant ou enregistrés dans une table temporaire lors de l’exécution de la section GLOBAL IN/JOIN.