Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

paramètres de session distributed_cache_*

Ces paramètres sont disponibles dans system.settings et sont générés automatiquement à partir du code source.

distributed_cache_alignment

Uniquement sur ClickHouse Cloud
Type
UInt64
Par défaut
0
Historique des versions
VersionValeur par défautCommentaire
25.70Renommage de distributed_cache_read_alignment

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

distributed_cache_bypass_connection_pool

Uniquement sur ClickHouse Cloud
Type
Bool
Par défaut
0
Historique des versions
VersionValeur par défautCommentaire
24.100Un paramètre pour ClickHouse Cloud

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

distributed_cache_client_id

Uniquement sur ClickHouse Cloud
Historique des versions
VersionValeur par défautCommentaire
26.9Nouveau paramètre (tests d’intégration continue uniquement) permettant de surcharger l’ID client du cache distribué pour chaque requête.
26.8Nouveau paramètre (tests d’intégration continue uniquement) permettant de surcharger l’ID client du cache distribué pour chaque requête.

N’a d’effet que dans ClickHouse Cloud. Ce paramètre, utilisé uniquement pour les tests d’intégration continue, surcharge, lorsqu’il n’est pas vide, l’ID client du cache distribué configuré dans le registry pour les requêtes de cette requête. Il permet aux tests de répartir les données entre un ensemble limité d’ID client tout en conservant les mêmes données sur le même ID client. Il nécessite l’activation de ci_mode dans la config du client de cache distribué : dans le cas contraire (ce qui est le comportement par défaut, notamment en production), une requête qui effectue une lecture ou une écriture via le cache distribué échoue avec SUPPORT_IS_DISABLED, au lieu de revenir silencieusement à l’ID client configuré. Les requêtes qui n’atteignent jamais le cache distribué ne sont pas affectées ; la valeur y est donc ignorée.

distributed_cache_connect_backoff_max_ms

Uniquement sur ClickHouse Cloud
Type
UInt64
Par défaut
50
Historique des versions
VersionValeur par défautCommentaire
25.850Nouveau 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é.

distributed_cache_connect_backoff_min_ms

Uniquement sur ClickHouse Cloud
Type
UInt64
Par défaut
0
Historique des versions
VersionValeur par défautCommentaire
25.80Nouveau 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é.

distributed_cache_connect_max_tries

Uniquement sur ClickHouse Cloud
Type
UInt64
Par défaut
5
Historique des versions
VersionValeur par défautCommentaire
25.85Valeur du paramètre modifiée
25.120Cloud uniquement
24.1020Paramètre pour ClickHouse Cloud

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

distributed_cache_connect_timeout_ms

Uniquement sur ClickHouse Cloud
Type
UInt64
Par défaut
50
Historique des versions
VersionValeur par défautCommentaire
25.1050Nouveau 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é.

distributed_cache_credentials_refresh_period_seconds

Uniquement sur ClickHouse Cloud
Type
UInt64
Par défaut
5
Historique des versions
VersionValeur par défautCommentaire
25.65Nouveau paramètre privé

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

distributed_cache_data_packet_ack_window

Uniquement sur ClickHouse Cloud
Type
UInt64
Par défaut
5
Historique des versions
VersionValeur par défautCommentaire
24.105Un 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é

distributed_cache_discard_connection_if_unread_data

Uniquement sur ClickHouse Cloud
Type
Bool
Par défaut
1
Historique des versions
VersionValeur par défautCommentaire
24.111Nouveau paramètre
24.101Nouveau paramètre

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

distributed_cache_fetch_metrics_only_from_current_az

Uniquement sur ClickHouse Cloud
Type
Bool
Par défaut
1
Historique des versions
VersionValeur par défautCommentaire
24.101Paramè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

distributed_cache_file_cache_name

Uniquement sur ClickHouse Cloud
Historique des versions
VersionValeur par défautCommentaire
26.1Nouveau 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é.

distributed_cache_log_mode

Uniquement sur ClickHouse Cloud
Type
DistributedCacheLogMode
Par défaut
on_error
Historique des versions
VersionValeur par défautCommentaire
24.10on_errorParamètre pour ClickHouse Cloud

N'a d'effet que dans ClickHouse Cloud. Mode d'écriture dans system.distributed_cache_log

distributed_cache_max_unacked_inflight_packets

Uniquement sur ClickHouse Cloud
Type
UInt64
Par défaut
10
Historique des versions
VersionValeur par défautCommentaire
24.1010Paramè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é

distributed_cache_min_bytes_for_seek

Uniquement sur ClickHouse Cloud
Type
UInt64
Par défaut
0
Historique des versions
VersionValeur par défautCommentaire
25.10Nouveau 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é.

distributed_cache_min_inflight_bytes_to_discard_connection_on_seek

Uniquement sur ClickHouse Cloud
Type
UInt64
Par défaut
4194304
Historique des versions
VersionValeur par défautCommentaire
26.94194304Nouveau paramètre permettant de fermer puis de rouvrir une connexion au cache distribué lors d'un seek, lorsque trop d'octets en transit devraient sinon être ignorés. La valeur par défaut est de 4 Mio ; 0 restaure le comportement précédent (toujours réutiliser la connexion via l'identifiant de plage de lecture).
26.84194304Nouveau paramètre permettant de fermer puis de rouvrir une connexion au cache distribué lors d'un seek, lorsque trop d'octets en transit devraient sinon être ignorés. La valeur par défaut est de 4 Mio ; 0 restaure le comportement précédent (toujours réutiliser la connexion via l'identifiant de plage de lecture).
26.74194304Nouveau paramètre permettant de fermer puis de rouvrir une connexion au cache distribué lors d'un seek, lorsque trop d'octets en transit devraient sinon être ignorés. La valeur par défaut est de 4 Mio ; 0 restaure le comportement précédent (toujours réutiliser la connexion via l'identifiant de plage de lecture).

N'a d'effet que dans ClickHouse Cloud. Lors d'un seek depuis la position actuelle d'un stream de cache distribué ouvert, si le nombre estimé d'octets en transit qui devraient être ignorés pour continuer à réutiliser la connexion (via le mécanisme d'identifiant de plage de lecture) dépasse cette valeur, fermez la connexion et ouvrez-en une nouvelle. Cela évite de purger une grande quantité de données inutilisées lorsque les seeks sont fréquents. 0 désactive ce comportement et réutilise toujours la connexion.

distributed_cache_pool_behaviour_on_limit

Uniquement sur ClickHouse Cloud
Type
DistributedCachePoolBehaviourOnLimit
Par défaut
wait
Historique des versions
VersionValeur par défautCommentaire
25.1waitCloud uniquement
24.10allocate_bypassing_poolUn 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

distributed_cache_prefer_bigger_buffer_size

Uniquement sur ClickHouse Cloud
Type
Bool
Par défaut
0
Historique des versions
VersionValeur par défautCommentaire
25.100Nouveau paramètre.

N'a d'effet que dans ClickHouse Cloud. Identique à filesystem_cache_prefer_bigger_buffer_size, mais pour le cache distribué.

distributed_cache_read_only_from_current_az

Uniquement sur ClickHouse Cloud
Type
Bool
Par défaut
1
Historique des versions
VersionValeur par défautCommentaire
25.51Nouveau 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é.

distributed_cache_read_request_max_tries

Uniquement sur ClickHouse Cloud
Type
UInt64
Par défaut
10
Historique des versions
VersionValeur par défautCommentaire
25.810Valeur du paramètre modifiée
25.420Nouveau 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.

distributed_cache_receive_response_wait_milliseconds

Uniquement sur ClickHouse Cloud
Type
UInt64
Par défaut
60000
Historique des versions
VersionValeur par défautCommentaire
24.1060000Paramè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é

distributed_cache_receive_timeout_milliseconds

Uniquement sur ClickHouse Cloud
Type
UInt64
Par défaut
10000
Historique des versions
VersionValeur par défautCommentaire
24.1010000Un 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.

distributed_cache_receive_timeout_ms

Uniquement sur ClickHouse Cloud
Type
UInt64
Par défaut
3000
Historique des versions
VersionValeur par défautCommentaire
25.103000Nouveau 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.

distributed_cache_registry_show_certificate_and_signature

Uniquement sur ClickHouse Cloud
Type
Bool
Par défaut
0
Historique des versions
VersionValeur par défautCommentaire
26.60Nouveau 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.

distributed_cache_send_timeout_ms

Uniquement sur ClickHouse Cloud
Type
UInt64
Par défaut
3000
Historique des versions
VersionValeur par défautCommentaire
25.103000Nouveau 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.

distributed_cache_tcp_keep_alive_timeout_ms

Uniquement sur ClickHouse Cloud
Type
UInt64
Par défaut
2900
Historique des versions
VersionValeur par défautCommentaire
25.102900Nouveau 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.

distributed_cache_throw_on_error

Uniquement sur ClickHouse Cloud
Type
Bool
Par défaut
0
Historique des versions
VersionValeur par défautCommentaire
24.100Paramè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é.

distributed_cache_use_clients_cache_for_read

Uniquement sur ClickHouse Cloud
Type
Bool
Par défaut
1
Historique des versions
VersionValeur par défautCommentaire
25.121Nouveau paramètre

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

distributed_cache_wait_connection_from_pool_milliseconds

Uniquement sur ClickHouse Cloud
Type
UInt64
Par défaut
100
Historique des versions
VersionValeur par défautCommentaire
24.10100Un 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

distributed_cache_write_request_max_tries

Uniquement sur ClickHouse Cloud
Type
UInt64
Par défaut
10
Historique des versions
VersionValeur par défautCommentaire
26.410Nouveau 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é

Navigation