Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

paramètres de session filesystem_cache_*

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

filesystem_cache_allow_background_download

Type
Bool
Par défaut
1
Historique des versions
VersionValeur par défautCommentaire
25.111Nouveau paramètre permettant de contrôler les téléchargements en arrière-plan dans le cache du système de fichiers pour chaque requête.

Autorise le cache du système de fichiers à mettre en file d’attente des téléchargements en arrière-plan pour les données lues depuis un stockage distant. Désactivez cette option pour que les téléchargements restent au premier plan pour la requête/session en cours.

filesystem_cache_boundary_alignment

Type
UInt64
Par défaut
0
Historique des versions
VersionValeur par défautCommentaire
24.110Nouveau paramètre

Alignement des limites du cache du système de fichiers. Ce paramètre s’applique uniquement aux lectures non effectuées sur disque (par exemple, au cache des moteurs de table distants / fonctions de table, mais pas à la configuration du stockage des tables MergeTree). La valeur 0 signifie qu’aucun alignement n’est appliqué.

filesystem_cache_enable_background_download_during_fetch

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

N’a d’effet que dans ClickHouse Cloud. Temps d'attente pour obtenir le verrou du cache lors de la réservation d'espace dans le cache du système de fichiers

filesystem_cache_enable_background_download_for_metadata_files_in_packed_storage

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

N'a d'effet que dans ClickHouse Cloud. Temps d'attente pour obtenir le verrou du cache lors de la réservation d'espace dans le cache du système de fichiers

filesystem_cache_max_download_size

Type
UInt64
Par défaut
137438953472

Taille maximale du cache du système de fichiers distant qu'une seule requête peut télécharger

filesystem_cache_name

Historique des versions
VersionValeur par défautCommentaire
24.10Nom du cache du système de fichiers à utiliser avec les moteurs de table sans état ou les lacs de données

Nom du cache du système de fichiers à utiliser avec les moteurs de table sans état ou les lacs de données

filesystem_cache_prefer_bigger_buffer_size

Type
Bool
Par défaut
1
Historique des versions
VersionValeur par défautCommentaire
24.111Nouveau paramètre

Privilégie une taille de tampon plus grande si le cache du système de fichiers est activé afin d'éviter l'écriture de petits segments de fichier, qui dégradent les performances du cache. En revanche, l'activation de ce paramètre peut augmenter l'utilisation de la mémoire.

filesystem_cache_reserve_space_wait_lock_timeout_milliseconds

Type
UInt64
Par défaut
1000
Historique des versions
VersionValeur par défautCommentaire
24.31000Temps d'attente pour obtenir le verrou du cache lors de la réservation d'espace dans le cache du système de fichiers

Temps d'attente pour obtenir le verrou du cache lors de la réservation d'espace dans le cache du système de fichiers

filesystem_cache_segments_batch_size

Type
UInt64
Par défaut
20

Limite de taille d’un lot unique de segments de fichier qu’un tampon de lecture peut demander au cache. Une valeur trop faible entraînera un nombre excessif de requêtes vers le cache, tandis qu’une valeur trop élevée peut ralentir l’éviction du cache

filesystem_cache_skip_download_if_exceeds_per_query_cache_write_limit

Alias : skip_download_if_exceeds_query_cache

Type
Bool
Par défaut
1
Historique des versions
VersionValeur par défautCommentaire
24.111Changement de nom du paramètre skip_download_if_exceeds_query_cache_limit

Ne pas télécharger depuis le système de fichiers distant si la taille du cache de requête est dépassée

filesystem_cache_verbose_logging

Type
Bool
Par défaut
0
Historique des versions
VersionValeur par défautCommentaire
26.80Nouveau paramètre qui contrôle les messages de journal de niveau TEST émis pour chaque remplissage du tampon de lecture du cache du système de fichiers, auparavant émis sans condition dès que le niveau de journalisation le permettait.

Émet des messages de journal de niveau TEST pour chaque remplissage du tampon du cache du système de fichiers (état de la lecture, taille restante à lire, octets lus). À utiliser uniquement à des fins de débogage : les messages sont formatés une fois par lecture. L’activer pour une requête effectuant de nombreuses petites lectures mises en cache entraîne donc une surcharge de journalisation importante. Les messages ne sont de toute façon visibles que lorsque le niveau de journalisation est test (voir send_logs_level).

filesystem_cache_wait_for_concurrent_download_timeout_milliseconds

Type
UInt64
Par défaut
1000
Historique des versions
VersionValeur par défautCommentaire
26.81000Nouveau paramètre limitant la durée d’attente d’une lecture pour un segment de fichier en cours de téléchargement dans le cache du système de fichiers par une requête concurrente ; en cas d’expiration du délai, la lecture contourne le cache au lieu d’attendre indéfiniment. La valeur précédente 60000 correspond à l’ancien comportement (un cycle d’attente complet de 60 s sur le téléchargeur).

Durée maximale d’attente d’un segment de fichier en cours de téléchargement dans le cache du système de fichiers par une requête concurrente. Lorsque le délai d’expiration est atteint, la lecture contourne le cache du système de fichiers pour cette plage et lit directement depuis le stockage distant, tandis que le téléchargement concurrent continue de remplir le cache. La valeur 0 signifie ne pas attendre du tout : contournez immédiatement le cache si la plage requise n’est pas encore téléchargée. Réduire cette valeur limite la latence de queue des lectures qui auraient autrement attendu le rythme de téléchargement d’une autre requête, au prix de requêtes supplémentaires vers le stockage distant.

Navigation