> ## 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 distributed_background_*

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

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 [source](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).

<div id="distributed_background_insert_batch">
  ## distributed\_background\_insert\_batch
</div>

**Alias** : `distributed_directory_monitor_batch_inserts`

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

Active ou désactive l’envoi des données insérées par lots.

Lorsque l’envoi par lots est activé, le moteur de table [Distributed](/docs/fr/reference/engines/table-engines/special/distributed) tente d’envoyer plusieurs fichiers de données insérées en une seule opération au lieu de les envoyer séparément. L’envoi par lots améliore les performances du cluster en exploitant plus efficacement les ressources du serveur et du réseau.

Valeurs possibles :

* 1 — Activé.
* 0 — Désactivé.

<div id="distributed_background_insert_max_sleep_time_ms">
  ## distributed\_background\_insert\_max\_sleep\_time\_ms
</div>

**Alias** : `distributed_directory_monitor_max_sleep_time_ms`

<SettingsInfoBlock type="Millisecondes" default_value="30000" />

Intervalle maximal avant l’envoi des données par le moteur de table [Distributed](/docs/fr/reference/engines/table-engines/special/distributed). Limite la croissance exponentielle de l’intervalle défini dans le paramètre [distributed\_background\_insert\_sleep\_time\_ms](/docs/fr/reference/settings/session-settings/distributed-background#distributed_background_insert_sleep_time_ms).

Valeurs possibles :

* Un nombre entier positif de millisecondes.

<div id="distributed_background_insert_sleep_time_ms">
  ## distributed\_background\_insert\_sleep\_time\_ms
</div>

**Alias** : `distributed_directory_monitor_sleep_time_ms`

<SettingsInfoBlock type="Millisecondes" default_value="100" />

Intervalle de base utilisé par le moteur de table [Distributed](/docs/fr/reference/engines/table-engines/special/distributed) pour envoyer les données. L’intervalle réel augmente de façon exponentielle en cas d’erreur.

Valeurs possibles :

* Un entier positif en millisecondes.

<div id="distributed_background_insert_split_batch_on_failure">
  ## distributed\_background\_insert\_split\_batch\_on\_failure
</div>

**Alias** : `distributed_directory_monitor_split_batch_on_failure`

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

Active ou désactive le fractionnement des lots en cas d’échec.

Il arrive parfois que l’envoi d’un lot donné vers le segment distant échoue, en raison d’un pipeline complexe en aval (par ex. `MATERIALIZED VIEW` avec `GROUP BY`), à cause de `Memory limit exceeded` ou d’erreurs similaires. Dans ce cas, réessayer ne servira à rien (et bloquera les envois distribués pour la table), mais l’envoi un par un des fichiers de ce lot peut permettre à l’INSERT de réussir.

Ainsi, définir ce paramètre sur `1` désactive le traitement par lots pour ces lots (c.-à-d. désactive temporairement `distributed_background_insert_batch` pour les lots en échec).

Valeurs possibles :

* 1 — Activé.
* 0 — Désactivé.

<Note>
  Ce paramètre affecte également les lots corrompus (qui peuvent apparaître à la suite d’un arrêt anormal du serveur (machine) et de l’absence de `fsync_after_insert`/`fsync_directories` pour le moteur de table [Distributed](/docs/fr/reference/engines/table-engines/special/distributed)).
</Note>

<Note>
  Vous ne devez pas compter sur le fractionnement automatique des lots, car cela peut nuire aux performances.
</Note>

<div id="distributed_background_insert_timeout">
  ## distributed\_background\_insert\_timeout
</div>

**Alias** : `insert_distributed_timeout`

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

Délai d’attente de la requête d’insertion dans Distributed. Ce paramètre est utilisé uniquement lorsque `insert_distributed_sync` est activé. Une valeur de 0 signifie qu’il n’y a pas de délai d’attente.