> ## 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.

# configurações de sessão distributed_background_*

> Configurações de sessão do ClickHouse no grupo gerado 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
  }}>Tipo</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{type}</div>
      <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>Padrão</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{default_value}</div>
      {changeable_without_restart && <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>
          Pode ser alterado sem reiniciar
        </div>}
      {changeable_without_restart && <div style={{
    overflowWrap: "anywhere"
  }}>
          {changeable_without_restart}
        </div>}
    </div>;
};

Essas configurações estão disponíveis em [system.settings](/docs/pt-BR/reference/system-tables/settings) e são geradas automaticamente a partir do [código-fonte](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).

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

**Aliases**: `distributed_directory_monitor_batch_inserts`

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

Ativa/desativa o envio, em lotes, de dados inseridos.

Quando o envio em lotes está ativado, o motor de tabela [Distributed](/docs/pt-BR/reference/engines/table-engines/special/distributed) tenta enviar vários arquivos com dados inseridos em uma única operação, em vez de enviá-los separadamente. O envio em lotes melhora o desempenho do cluster ao aproveitar melhor os recursos do servidor e da rede.

Valores possíveis:

* 1 — Ativado.
* 0 — Desativado.

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

**Aliases**: `distributed_directory_monitor_max_sleep_time_ms`

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

Intervalo máximo para que o motor de tabela [Distributed](/docs/pt-BR/reference/engines/table-engines/special/distributed) envie dados. Limita o crescimento exponencial do intervalo definido na configuração [distributed\_background\_insert\_sleep\_time\_ms](/docs/pt-BR/reference/settings/session-settings/distributed-background#distributed_background_insert_sleep_time_ms).

Valores possíveis:

* Um número inteiro positivo de milissegundos.

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

**Aliases**: `distributed_directory_monitor_sleep_time_ms`

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

Intervalo base para o motor de tabela [Distributed](/docs/pt-BR/reference/engines/table-engines/special/distributed) enviar dados. O intervalo efetivo aumenta exponencialmente em caso de erros.

Valores possíveis:

* Um número inteiro positivo, em milissegundos.

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

**Aliases**: `distributed_directory_monitor_split_batch_on_failure`

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

Habilita/desabilita a divisão de lotes em caso de falha.

Às vezes, o envio de um lote específico para o shard remoto pode falhar por causa de algum pipeline complexo posterior (isto é, `MATERIALIZED VIEW` com `GROUP BY`), devido a `Memory limit exceeded` ou erros semelhantes. Nesse caso, tentar novamente não ajudará (e isso deixará travados os envios distribuídos da tabela), mas enviar os arquivos desse lote um a um pode fazer com que o INSERT seja bem-sucedido.

Portanto, definir esta configuração como `1` desabilita o batching para esses lotes (isto é, desabilita temporariamente `distributed_background_insert_batch` para lotes com falha).

Valores possíveis:

* 1 — Habilitado.
* 0 — Desabilitado.

<Note>
  Esta configuração também afeta lotes corrompidos (que podem aparecer devido ao encerramento anormal do servidor (máquina) e à ausência de `fsync_after_insert`/`fsync_directories` para o motor de tabela [Distributed](/docs/pt-BR/reference/engines/table-engines/special/distributed)).
</Note>

<Note>
  Você não deve confiar na divisão automática de lotes, pois isso pode prejudicar o desempenho.
</Note>

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

**Aliases**: `insert_distributed_timeout`

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

Tempo limite para a consulta de `insert` no Distributed. Essa configuração é usada somente com `insert_distributed_sync` habilitado. O valor zero significa que não há tempo limite.