> ## 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 table MergeTree map_buckets_*

> Paramètres de table MergeTree de ClickHouse dans le groupe généré map_buckets_*.

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 générés automatiquement à partir du code source de ClickHouse.

<div id="map_buckets_coefficient">
  ## map\_buckets\_coefficient
</div>

<SettingsInfoBlock type="Float" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.3"},{"label": "1"},{"label": "Ajout d'un paramètre permettant de contrôler le coefficient utilisé dans les stratégies `sqrt` et `linear` pour calculer le nombre de buckets pour la sérialisation Map `with_buckets`"}]}]} />

Le coefficient utilisé dans les stratégies [map\_buckets\_strategy](/docs/fr/reference/settings/merge-tree-settings/map-buckets#map_buckets_strategy) `sqrt` et `linear` pour calculer le nombre de buckets à partir de la taille moyenne de la map.
Pour la stratégie `sqrt` : `round(map_buckets_coefficient * sqrt(avg_map_size))`.
Pour la stratégie `linear` : `round(map_buckets_coefficient * avg_map_size)`.
Ignoré lorsque `map_buckets_strategy` est défini sur `constant`.

<div id="map_buckets_min_avg_size">
  ## map\_buckets\_min\_avg\_size
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.3"},{"label": "32"},{"label": "Ajoute un paramètre pour contrôler la taille moyenne minimale des maps (nombre de clés par ligne) requise pour appliquer la sérialisation `with_buckets`"}]}]} />

Taille moyenne minimale des maps (nombre de clés par ligne) requise pour appliquer la sérialisation `with_buckets`.
Si la taille moyenne des maps est inférieure à cette valeur, un seul bucket est utilisé, quels que soient les autres paramètres de bucket.
Une valeur de `0` désactive ce seuil et applique toujours la stratégie de bucketing.
Ce paramètre est utile pour éviter le surcoût de la sérialisation en buckets pour les petites maps, lorsque le gain est négligeable.

<div id="map_buckets_strategy">
  ## map\_buckets\_strategy
</div>

<SettingsInfoBlock type="MergeTreeMapBucketsStrategy" default_value="sqrt" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.3"},{"label": "sqrt"},{"label": "Ajout d'un paramètre permettant de contrôler la stratégie de sélection du nombre de buckets pour la sérialisation Map `with_buckets`"}]}]} />

Contrôle la stratégie utilisée pour déterminer le nombre de buckets dans la sérialisation Map `with_buckets`, en fonction de la taille moyenne des maps.

Valeurs possibles :

* constant — Utilise toujours [max\_buckets\_in\_map](/docs/fr/reference/settings/merge-tree-settings/max#max_buckets_in_map) comme nombre de buckets, quelle que soit la taille moyenne des maps.
* sqrt — Utilise `round(map_buckets_coefficient * sqrt(avg_map_size))` comme nombre de buckets, limité à l'intervalle `[1, max_buckets_in_map]`.
* linear — Utilise `round(map_buckets_coefficient * avg_map_size)` comme nombre de buckets, limité à l'intervalle `[1, max_buckets_in_map]`.