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

# configuraciones de sesión de distributed_background_*

> Configuraciones de sesión de ClickHouse del grupo generado 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"
  }}>Predeterminado</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{default_value}</div>
      {changeable_without_restart && <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>
          Modificable sin reiniciar
        </div>}
      {changeable_without_restart && <div style={{
    overflowWrap: "anywhere"
  }}>
          {changeable_without_restart}
        </div>}
    </div>;
};

Estas opciones de configuración están disponibles en [system.settings](/docs/es/reference/system-tables/settings) y se generan automáticamente a partir del [código fuente](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" />

Habilita/deshabilita el envío por lotes de los datos insertados.

Cuando el envío por lotes está habilitado, el motor de tabla [Distributed](/docs/es/reference/engines/table-engines/special/distributed) intenta enviar varios archivos de datos insertados en una sola operación, en lugar de enviarlos por separado. El envío por lotes mejora el rendimiento del clúster al aprovechar mejor los recursos del servidor y de la red.

Valores posibles:

* 1 — Habilitado.
* 0 — Deshabilitado.

<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="Milisegundos" default_value="30000" />

Intervalo máximo para que el motor de tabla [Distributed](/docs/es/reference/engines/table-engines/special/distributed) envíe datos. Limita el crecimiento exponencial del intervalo establecido en el ajuste [distributed\_background\_insert\_sleep\_time\_ms](/docs/es/reference/settings/session-settings/distributed-background#distributed_background_insert_sleep_time_ms).

Valores posibles:

* Un número entero positivo de milisegundos.

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

**Alias**: `distributed_directory_monitor_sleep_time_ms`

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

Intervalo base que utiliza el motor de tabla [Distributed](/docs/es/reference/engines/table-engines/special/distributed) para enviar datos. El intervalo real aumenta exponencialmente en caso de errores.

Valores posibles:

* Un número entero positivo de milisegundos.

<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 o deshabilita la división de lotes cuando se producen fallos.

A veces, el envío de un lote concreto al segmento remoto puede fallar debido a algún pipeline posterior complejo (por ejemplo, `MATERIALIZED VIEW` con `GROUP BY`) por errores como `Memory limit exceeded` u otros similares. En este caso, reintentar no servirá de ayuda (y esto bloqueará los envíos distribuidos de la tabla), pero enviar los archivos de ese lote uno por uno puede permitir que el `INSERT` se complete correctamente.

Por tanto, establecer esta configuración en `1` deshabilitará el procesamiento por lotes para esos lotes (es decir, deshabilitará temporalmente `distributed_background_insert_batch` para los lotes fallidos).

Valores posibles:

* 1 — Habilitado.
* 0 — Deshabilitado.

<Note>
  Esta configuración también afecta a los lotes dañados (que pueden aparecer debido a una terminación anómala del servidor \[máquina] y a la ausencia de `fsync_after_insert`/`fsync_directories` para el motor de tabla [Distributed](/docs/es/reference/engines/table-engines/special/distributed)).
</Note>

<Note>
  No debería depender de la división automática de lotes, ya que puede perjudicar al rendimiento.
</Note>

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

**Alias**: `insert_distributed_timeout`

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

Tiempo de espera de la consulta de inserción en Distributed. Esta configuración solo se usa cuando insert\_distributed\_sync está habilitado. Un valor de cero significa que no hay tiempo de espera.