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

> Les paramètres de session ClickHouse du groupe généré 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
  }}>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>;
};

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>
            {'Uniquement sur ClickHouse Cloud'}
        </div>;
};

Ces paramètres sont disponibles dans [system.settings](/docs/fr/reference/system-tables/settings) et sont générés automatiquement à partir du [code source](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": "Renommage de distributed_cache_read_alignment"}]}]} />

N'a d'effet que dans ClickHouse Cloud. Paramètre de test, ne le modifiez pas

<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": "Un paramètre pour ClickHouse Cloud"}]}]} />

N'a d'effet que dans ClickHouse Cloud. Permet de contourner le pool de connexions du cache distribué

<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": "Nouveau paramètre"}]}]} />

N’a d’effet que dans ClickHouse Cloud. Valeur maximale du backoff, en millisecondes, lors de l’établissement d’une connexion au cache distribué.

<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": "Nouveau paramètre"}]}]} />

N’a d’effet que dans ClickHouse Cloud. Durée minimale de backoff, en millisecondes, pour la création de connexions au cache distribué.

<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": "Valeur du paramètre modifiée"}]}, {"id": "row-2","items": [{"label": "25.1"},{"label": "20"},{"label": "Cloud uniquement"}]}, {"id": "row-3","items": [{"label": "24.10"},{"label": "20"},{"label": "Paramètre pour ClickHouse Cloud"}]}]} />

N'a d'effet que dans ClickHouse Cloud. Nombre de tentatives de connexion au cache distribué en cas d'échec.

<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": "Nouveau paramètre"}]}]} />

N'a d'effet que dans ClickHouse Cloud. Délai d'expiration de la connexion lors de l'établissement d'une connexion au serveur de cache distribué.

<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": "Nouveau paramètre privé"}]}]} />

N’a d’effet que dans ClickHouse Cloud. Période de rafraîchissement des informations d’authentification.

<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": "Un paramètre pour ClickHouse Cloud"}]}]} />

N’a d’effet que dans ClickHouse Cloud. Fenêtre d’envoi des ACK pour une séquence de DataPacket dans une seule requête de lecture du cache distribué

<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": "Nouveau paramètre"}]}, {"id": "row-2","items": [{"label": "24.10"},{"label": "1"},{"label": "Nouveau paramètre"}]}]} />

N'a d'effet que dans ClickHouse Cloud. Ignore la connexion si certaines données n'ont pas été lues.

<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": "Paramètre pour ClickHouse Cloud"}]}]} />

N’a d’effet que dans ClickHouse Cloud. Ne récupère les métriques que depuis la zone de disponibilité actuelle dans 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": "Nouveau paramètre."}]}]} />

N'a d'effet que dans ClickHouse Cloud. Paramètre utilisé uniquement pour les tests d’intégration continue : nom du cache du système de fichiers à utiliser pour le cache distribué.

<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": "Paramètre pour ClickHouse Cloud"}]}]} />

N'a d'effet que dans ClickHouse Cloud. Mode d'écriture dans 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": "Paramètre pour ClickHouse Cloud"}]}]} />

N'a d'effet que dans ClickHouse Cloud. Nombre maximal de paquets non acquittés en transit dans une seule requête de lecture du cache distribué

<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": "Nouveau paramètre privé."}]}]} />

N’a d’effet que dans ClickHouse Cloud. Nombre minimal d’octets pour effectuer une opération de seek dans le cache distribué.

<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": "Cloud uniquement"}]}, {"id": "row-2","items": [{"label": "24.10"},{"label": "allocate_bypassing_pool"},{"label": "Un paramètre pour ClickHouse Cloud"}]}]} />

N'a d'effet que dans ClickHouse Cloud. Définit le comportement de la connexion au cache distribué lorsque la limite du pool est atteinte

<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": "Nouveau paramètre."}]}]} />

N'a d'effet que dans ClickHouse Cloud. Identique à filesystem\_cache\_prefer\_bigger\_buffer\_size, mais pour le cache distribué.

<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": "Nouveau paramètre"}]}]} />

N'a d'effet que dans ClickHouse Cloud. Permet de lire uniquement depuis la zone de disponibilité actuelle. Si désactivé, la lecture s'effectuera depuis tous les serveurs de cache de toutes les zones de disponibilité.

<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": "Valeur du paramètre modifiée"}]}, {"id": "row-2","items": [{"label": "25.4"},{"label": "20"},{"label": "Nouveau paramètre"}]}]} />

N’a d’effet que dans ClickHouse Cloud. Nombre de tentatives d’une requête de lecture du cache distribué en cas d’échec.

<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": "Paramètre pour ClickHouse Cloud"}]}]} />

N'a d'effet que dans ClickHouse Cloud. Délai d'attente, en millisecondes, pour recevoir les données d'une requête depuis le cache distribué

<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 paramètre pour ClickHouse Cloud"}]}]} />

N'a d'effet que dans ClickHouse Cloud. Temps d'attente, en millisecondes, pour recevoir tout type de réponse du cache distribué

Valeur par défaut de 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": "Nouveau paramètre"}]}]} />

N’a d’effet que dans ClickHouse Cloud. Délai d’attente, en millisecondes, pour la réception de données depuis le serveur de cache distribué. Si aucun octet n’est reçu pendant cet intervalle, une exception est levée.

<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": "Nouveau paramètre permettant d’afficher les colonnes `certificate` et `signature` dans `system.distributed_cache_registry`."}]}]} />

N’a d’effet que dans ClickHouse Cloud. Affiche les colonnes `certificate` et `signature` dans la table `system.distributed_cache_registry`. Par défaut, ces colonnes sont vides afin de conserver un affichage compact ; activez ce paramètre pour les examiner.

<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": "Nouveau paramètre"}]}]} />

N’a d’effet que dans ClickHouse Cloud. Délai d’expiration pour l’envoi de données vers le serveur de cache distribué, en millisecondes. Si un client doit envoyer des données mais ne parvient à envoyer aucun octet pendant cet intervalle, une exception est levée.

<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": "Nouveau paramètre"}]}]} />

N'a d'effet que dans ClickHouse Cloud. Temps, en millisecondes, pendant lequel la connexion au serveur de cache distribué doit rester inactive avant que TCP ne commence à envoyer des sondes 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": "Paramètre pour ClickHouse Cloud"}]}]} />

N’a d’effet que dans ClickHouse Cloud. Relance l’exception survenue lors de la communication avec le cache distribué ou l’exception reçue de celui-ci. Sinon, en cas d’erreur, se rabat sur l’ignorance du cache distribué.

<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": "Nouveau paramètre"}]}]} />

N'a d'effet que dans ClickHouse Cloud. Utilise le cache client pour les requêtes de lecture.

<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": "Un paramètre pour ClickHouse Cloud"}]}]} />

N'a d'effet que dans ClickHouse Cloud. Temps d'attente, en millisecondes, pour obtenir une connexion du pool de connexions si distributed\_cache\_pool\_behaviour\_on\_limit est défini sur 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": "Nouveau paramètre"}]}]} />

N’a d’effet que dans ClickHouse Cloud. Nombre de tentatives en cas d’échec d’une requête d’écriture dans le cache distribué