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

# ajustes de sesión de distributed_cache_*

> Ajustes de sesión de ClickHouse en el grupo generado distributed_cache_*.

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>;
};

export const CloudOnlyBadge = () => {
  return <div className="cloudBadge">
            <div className="cloudIcon">
            <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path fillRule="evenodd" clipRule="evenodd" d="M5.33395 12.6667H12.3739C13.6593 12.6667 14.7073 11.6187 14.7073 10.3334C14.7073 9.04804 13.6593 8.00004 12.3739 8.00004H12.0839V7.33337C12.0839 5.12671 10.2906 3.33337 8.08395 3.33337C6.09928 3.33337 4.45395 4.78537 4.14195 6.68204C2.55728 6.76271 1.29395 8.06204 1.29395 9.66671C1.29395 11.3234 2.63728 12.6667 4.29395 12.6667H5.33395Z" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round" />
            </svg>
        </div>
            {'Solo para ClickHouse Cloud'}
        </div>;
};

Estos ajustes 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_cache_alignment">
  ## distributed\_cache\_alignment
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.7"},{"label": "0"},{"label": "Se renombró distributed_cache_read_alignment"}]}]} />

Solo tiene efecto en ClickHouse Cloud. Es una configuración para pruebas; no la cambie

<div id="distributed_cache_bypass_connection_pool">
  ## distributed\_cache\_bypass\_connection\_pool
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": "0"},{"label": "Una opción de configuración para ClickHouse Cloud"}]}]} />

Solo tiene efecto en ClickHouse Cloud. Permite omitir el pool de conexiones de caché distribuida

<div id="distributed_cache_connect_backoff_max_ms">
  ## distributed\_cache\_connect\_backoff\_max\_ms
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "50"},{"label": "Nuevo ajuste"}]}]} />

Solo tiene efecto en ClickHouse Cloud. Número máximo de milisegundos de backoff para la creación de conexiones de caché distribuida.

<div id="distributed_cache_connect_backoff_min_ms">
  ## distributed\_cache\_connect\_backoff\_min\_ms
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "0"},{"label": "Nueva configuración"}]}]} />

Solo tiene efecto en ClickHouse Cloud. Número mínimo de milisegundos de espera entre reintentos al crear conexiones de caché distribuida.

<div id="distributed_cache_connect_max_tries">
  ## distributed\_cache\_connect\_max\_tries
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "5"},{"label": "Valor de configuración modificado"}]}, {"id": "row-2","items": [{"label": "25.1"},{"label": "20"},{"label": "Solo en Cloud"}]}, {"id": "row-3","items": [{"label": "24.10"},{"label": "20"},{"label": "Una configuración para ClickHouse Cloud"}]}]} />

Solo tiene efecto en ClickHouse Cloud. Número de intentos de conexión a caché distribuida en caso de error

<div id="distributed_cache_connect_timeout_ms">
  ## distributed\_cache\_connect\_timeout\_ms
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.10"},{"label": "50"},{"label": "Nueva configuración"}]}]} />

Solo tiene efecto en ClickHouse Cloud. Tiempo de espera de la conexión al conectarse al servidor de caché distribuida.

<div id="distributed_cache_credentials_refresh_period_seconds">
  ## distributed\_cache\_credentials\_refresh\_period\_seconds
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.6"},{"label": "5"},{"label": "Nueva configuración privada"}]}]} />

Solo tiene efecto en ClickHouse Cloud. Período de actualización de las credenciales.

<div id="distributed_cache_data_packet_ack_window">
  ## distributed\_cache\_data\_packet\_ack\_window
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": "5"},{"label": "Una configuración de ClickHouse Cloud"}]}]} />

Solo surte efecto en ClickHouse Cloud. Ventana para enviar ACK de la secuencia de DataPacket en una única solicitud de lectura de caché distribuida

<div id="distributed_cache_discard_connection_if_unread_data">
  ## distributed\_cache\_discard\_connection\_if\_unread\_data
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.11"},{"label": "1"},{"label": "Nueva configuración"}]}, {"id": "row-2","items": [{"label": "24.10"},{"label": "1"},{"label": "Nueva configuración"}]}]} />

Solo tiene efecto en ClickHouse Cloud. Descarta la conexión si quedan datos sin leer.

<div id="distributed_cache_fetch_metrics_only_from_current_az">
  ## distributed\_cache\_fetch\_metrics\_only\_from\_current\_az
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": "1"},{"label": "Una configuración para ClickHouse Cloud"}]}]} />

Solo tiene efecto en ClickHouse Cloud. Recupera métricas únicamente de la zona de disponibilidad actual en system.distributed\_cache\_metrics, system.distributed\_cache\_events

<div id="distributed_cache_file_cache_name">
  ## distributed\_cache\_file\_cache\_name
</div>

<CloudOnlyBadge />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.1"},{"label": ""},{"label": "Nueva configuración."}]}]} />

Solo tiene efecto en ClickHouse Cloud. Configuración usada solo para pruebas de CI: nombre de la caché del sistema de archivos que se usará en caché distribuida.

<div id="distributed_cache_log_mode">
  ## distributed\_cache\_log\_mode
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="DistributedCacheLogMode" default_value="on_error" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": "on_error"},{"label": "Una configuración de ClickHouse Cloud"}]}]} />

Solo surte efecto en ClickHouse Cloud. Modo de escritura en system.distributed\_cache\_log

<div id="distributed_cache_max_unacked_inflight_packets">
  ## distributed\_cache\_max\_unacked\_inflight\_packets
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": "10"},{"label": "Una configuración de ClickHouse Cloud"}]}]} />

Solo tiene efecto en ClickHouse Cloud. Número máximo de paquetes en tránsito sin confirmar en una única solicitud de lectura del caché distribuida

<div id="distributed_cache_min_bytes_for_seek">
  ## distributed\_cache\_min\_bytes\_for\_seek
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "0"},{"label": "Nueva configuración privada."}]}]} />

Solo tiene efecto en ClickHouse Cloud. Número mínimo de bytes para realizar un seek en caché distribuida.

<div id="distributed_cache_pool_behaviour_on_limit">
  ## distributed\_cache\_pool\_behaviour\_on\_limit
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="DistributedCachePoolBehaviourOnLimit" default_value="wait" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "wait"},{"label": "Solo en Cloud"}]}, {"id": "row-2","items": [{"label": "24.10"},{"label": "allocate_bypassing_pool"},{"label": "Una configuración de ClickHouse Cloud"}]}]} />

Solo tiene efecto en ClickHouse Cloud. Identifica el comportamiento de la conexión de caché distribuida cuando se alcanza el límite del grupo

<div id="distributed_cache_prefer_bigger_buffer_size">
  ## distributed\_cache\_prefer\_bigger\_buffer\_size
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.10"},{"label": "0"},{"label": "Nueva configuración."}]}]} />

Solo tiene efecto en ClickHouse Cloud. Lo mismo que filesystem\_cache\_prefer\_bigger\_buffer\_size, pero para caché distribuida.

<div id="distributed_cache_read_only_from_current_az">
  ## distributed\_cache\_read\_only\_from\_current\_az
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.5"},{"label": "1"},{"label": "Nuevo ajuste"}]}]} />

Solo tiene efecto en ClickHouse Cloud. Permite leer solo desde la zona de disponibilidad actual. Si se desactiva, leerá desde todos los servidores de caché de todas las zonas de disponibilidad.

<div id="distributed_cache_read_request_max_tries">
  ## distributed\_cache\_read\_request\_max\_tries
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "10"},{"label": "Valor de la configuración cambiado"}]}, {"id": "row-2","items": [{"label": "25.4"},{"label": "20"},{"label": "Nueva configuración"}]}]} />

Solo tiene efecto en ClickHouse Cloud. Número de intentos para realizar una solicitud de lectura a caché distribuida si no tiene éxito

<div id="distributed_cache_receive_response_wait_milliseconds">
  ## distributed\_cache\_receive\_response\_wait\_milliseconds
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": "60000"},{"label": "Una configuración para ClickHouse Cloud"}]}]} />

Solo tiene efecto en ClickHouse Cloud. Tiempo de espera en milisegundos para recibir datos de una solicitud desde caché distribuida

<div id="distributed_cache_receive_timeout_milliseconds">
  ## distributed\_cache\_receive\_timeout\_milliseconds
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": "10000"},{"label": "Un ajuste para ClickHouse Cloud"}]}]} />

Solo tiene efecto en ClickHouse Cloud. Tiempo de espera, en milisegundos, para recibir cualquier tipo de respuesta de la caché distribuida

Valor predeterminado en Cloud: `20000`.

<div id="distributed_cache_receive_timeout_ms">
  ## distributed\_cache\_receive\_timeout\_ms
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.10"},{"label": "3000"},{"label": "Nueva configuración"}]}]} />

Solo tiene efecto en ClickHouse Cloud. Tiempo de espera para recibir datos desde el servidor de Distributed Cache, en milisegundos. Si no se recibe ningún byte durante este intervalo, se lanza una excepción.

<div id="distributed_cache_registry_show_certificate_and_signature">
  ## distributed\_cache\_registry\_show\_certificate\_and\_signature
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.6"},{"label": "0"},{"label": "Nueva opción de configuración para mostrar las columnas `certificate` y `signature` en `system.distributed_cache_registry`."}]}]} />

Solo tiene efecto en ClickHouse Cloud. Muestra las columnas `certificate` y `signature` en la tabla `system.distributed_cache_registry`. De forma predeterminada, estas columnas están vacías para mantener la salida compacta; habilita esta opción para inspeccionarlas.

<div id="distributed_cache_send_timeout_ms">
  ## distributed\_cache\_send\_timeout\_ms
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.10"},{"label": "3000"},{"label": "Nueva configuración"}]}]} />

Solo tiene efecto en ClickHouse Cloud. Tiempo de espera para enviar datos al servidor de caché distribuida, en milisegundos. Si un client necesita enviar datos pero no puede enviar ningún byte dentro de este intervalo, se lanza una excepción.

<div id="distributed_cache_tcp_keep_alive_timeout_ms">
  ## distributed\_cache\_tcp\_keep\_alive\_timeout\_ms
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.10"},{"label": "2900"},{"label": "Nueva configuración"}]}]} />

Solo tiene efecto en ClickHouse Cloud. Es el tiempo, en milisegundos, que la conexión con el servidor de Distributed Cache debe permanecer inactiva antes de que TCP comience a enviar sondas de keepalive.

<div id="distributed_cache_throw_on_error">
  ## distributed\_cache\_throw\_on\_error
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": "0"},{"label": "Una configuración para ClickHouse Cloud"}]}]} />

Solo tiene efecto en ClickHouse Cloud. Vuelve a lanzar cualquier excepción que se produzca durante la comunicación con la caché distribuida o cualquier excepción recibida de la caché distribuida. En caso contrario, omite la caché distribuida si se produce un error.

<div id="distributed_cache_use_clients_cache_for_read">
  ## distributed\_cache\_use\_clients\_cache\_for\_read
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.12"},{"label": "1"},{"label": "Nueva configuración"}]}]} />

Solo tiene efecto en ClickHouse Cloud. Usa la caché de los clientes para solicitudes de lectura.

<div id="distributed_cache_wait_connection_from_pool_milliseconds">
  ## distributed\_cache\_wait\_connection\_from\_pool\_milliseconds
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": "100"},{"label": "Una configuración para ClickHouse Cloud"}]}]} />

Solo tiene efecto en ClickHouse Cloud. Tiempo de espera, en milisegundos, para obtener una conexión del grupo de conexiones si distributed\_cache\_pool\_behaviour\_on\_limit es wait

<div id="distributed_cache_write_request_max_tries">
  ## distributed\_cache\_write\_request\_max\_tries
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.4"},{"label": "10"},{"label": "Nueva configuración"}]}]} />

Solo tiene efecto en ClickHouse Cloud. Número de intentos para realizar una solicitud de escritura en la caché distribuida si falla