> ## 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 number_of_* des tables MergeTree

> Paramètres des tables MergeTree de ClickHouse dans le groupe généré number_of_*.

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.merge\_tree\_settings](/docs/fr/reference/system-tables/merge_tree_settings) et sont autogénérés à partir du code source de ClickHouse.

<div id="number_of_free_entries_in_pool_to_execute_mutation">
  ## number\_of\_free\_entries\_in\_pool\_to\_execute\_mutation
</div>

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

Lorsque le nombre d'entrées libres dans le pool est inférieur à la valeur spécifiée, les mutations de parts ne sont pas exécutées. Cela permet de laisser des threads disponibles pour les fusions régulières et d'éviter les erreurs "Too many parts".

Valeurs possibles :

* Tout entier positif.

**Utilisation**

La valeur du paramètre `number_of_free_entries_in_pool_to_execute_mutation`
doit être inférieure à la valeur de [background\_pool\_size](/docs/fr/reference/settings/server-settings/settings#background_pool_size)

* [background\_merges\_mutations\_concurrency\_ratio](/docs/fr/reference/settings/server-settings/settings#background_merges_mutations_concurrency_ratio).
  Sinon, ClickHouse génère une exception.

<div id="number_of_free_entries_in_pool_to_execute_optimize_entire_partition">
  ## number\_of\_free\_entries\_in\_pool\_to\_execute\_optimize\_entire\_partition
</div>

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

Lorsque le nombre d'entrées libres dans le pool est inférieur au nombre spécifié, ne pas
exécuter l'optimisation de la partition entière en arrière-plan (cette tâche est générée
lorsque `min_age_to_force_merge_seconds` est défini et que
`min_age_to_force_merge_on_partition_only` est activé). Cela permet de laisser des threads libres
pour les fusions habituelles et d'éviter « Too many parts ».

Valeurs possibles :

* Entier positif.

La valeur du paramètre `number_of_free_entries_in_pool_to_execute_optimize_entire_partition`
doit être inférieure à la valeur de
[background\_pool\_size](/docs/fr/reference/settings/server-settings/settings#background_pool_size)

* [background\_merges\_mutations\_concurrency\_ratio](/docs/fr/reference/settings/server-settings/settings#background_merges_mutations_concurrency_ratio).
  Sinon, ClickHouse lève une exception.

<div id="number_of_free_entries_in_pool_to_lower_max_size_of_merge">
  ## number\_of\_free\_entries\_in\_pool\_to\_lower\_max\_size\_of\_merge
</div>

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

Lorsque le nombre d'entrées libres dans le pool
(ou la file d'attente répliquée) devient inférieur au nombre spécifié, commence à réduire la taille maximale de fusion à traiter
(ou à placer dans la file d'attente).
Cela permet de traiter les petites fusions, sans saturer le pool avec des
fusions de longue durée.

Valeurs possibles :

* Tout entier positif.

<div id="number_of_mutations_to_delay">
  ## number\_of\_mutations\_to\_delay
</div>

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

Si la table comporte au moins
ce nombre de mutations non terminées, ralentissez artificiellement les mutations de la table.
Désactivé si la valeur est 0

<div id="number_of_mutations_to_throw">
  ## number\_of\_mutations\_to\_throw
</div>

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

Si la table comporte au moins ce nombre de mutations inachevées, l'exception 'Too many mutations' est générée.
Désactivé si défini sur 0

<div id="number_of_partitions_to_consider_for_merge">
  ## number\_of\_partitions\_to\_consider\_for\_merge
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "10"},{"label": "Cloud sync"}]}]} />

Disponible uniquement dans ClickHouse Cloud. Jusqu’à N partitions peuvent être
prises en compte pour une fusion. Les partitions sont choisies de façon
aléatoire selon une pondération, où le poids correspond au nombre de data parts
pouvant être fusionnées dans cette partition.
