Skip to main content

Description

Contient des informations sur l’ensemble des paramètres du cache du système de fichiers

Colonnes

  • cache_name (String) — nom du cache
  • path (String) — chemin du répertoire du cache
  • max_size (UInt64) — taille maximale du cache
  • max_elements (UInt64) — nombre maximal d’éléments du cache, par ex. des segments de fichier (limite le nombre de fichiers sur le système de fichiers)
  • max_file_segment_size (UInt64) — taille maximale d’un segment de fichier unique
  • boundary_alignment (UInt64) — alignement des segments de fichier
  • cache_on_write_operations (UInt8) — active le cache en écriture immédiate (mise en cache lors de INSERT et MERGE)
  • cache_policy (String) — politique d’éviction du cache
  • slru_size_ratio (Float64) — ratio de taille de la politique de cache SLRU entre les éléments protégés et ceux en probation
  • background_download_threads (UInt64) — nombre de threads de téléchargement en arrière-plan. La valeur 0 désactive le téléchargement en arrière-plan
  • background_download_queue_size_limit (UInt64) — taille de la file d’attente de téléchargement en arrière-plan. La valeur 0 désactive le téléchargement en arrière-plan
  • background_download_max_file_segment_size (UInt64) — taille maximale pouvant être téléchargée en arrière-plan
  • load_metadata_threads (UInt64) — nombre maximal de threads utilisés pour charger les métadonnées du cache au démarrage du serveur
  • load_metadata_asynchronously (UInt8) — active le chargement asynchrone des métadonnées au démarrage du serveur
  • keep_free_space_size_ratio (Float64) — ratio d’espace libre que le cache tente de maintenir en arrière-plan
  • keep_free_space_elements_ratio (Float64) — ratio d’éléments libres que le cache tente de maintenir en arrière-plan
  • keep_free_space_remove_batch (UInt64) — taille du lot de suppression des éléments du cache effectuée par le thread d’arrière-plan qui maintient le ratio d’espace libre/d’éléments libres
  • invalidated_entries_cleanup_interval_ms (UInt64) — intervalle d’inactivité, en millisecondes, de la tâche d’arrière-plan qui purge les entrées invalidées (supprimées de manière différée) de la file de priorité
  • invalidated_entries_cleanup_threshold (UInt64) — nombre d’entrées invalidées accumulées dans la file de priorité qui déclenche leur suppression en arrière-plan
  • invalidated_entries_cleanup_remove_batch (UInt64) — nombre maximal d’entrées invalidées de la file de priorité supprimées sous un seul verrou d’écriture à chaque itération en arrière-plan
  • enable_filesystem_query_cache_limit (UInt8) — active la limitation de la taille maximale du cache pouvant être écrite dans le cadre d’une requête
  • cache_hits_threshold (UInt64) — paramètre obsolète
  • enable_bypass_cache_with_threshold (UInt8) — Non documenté. Utilisation non recommandée
  • bypass_cache_threshold (UInt64) — Non documenté. Utilisation non recommandée
  • write_cache_per_user_id_directory (UInt8) — paramètre interne de ClickHouse Cloud
  • allow_dynamic_cache_resize (UInt8) — Autorise le redimensionnement dynamique du cache du système de fichiers
  • max_size_ratio_to_total_space (Float64) — Rapport entre max_size et l’espace disque total
  • skip_cache_on_disk_failure (UInt8) — Si true, ignore silencieusement les opérations du cache du système de fichiers en cas d’erreurs d’E/S disque. Si false (par défaut), les erreurs d’E/S disque sont propagées comme des échecs au démarrage.
  • use_split_cache (UInt8) — Utilise la séparation des fichiers entre system et data.
  • split_cache_ratio (Float64) — Rapport entre le segment system et la taille totale du cache pour split_cache.
  • overcommit_eviction_evict_step (UInt64) — Pas d’éviction en octets pour la politique d’éviction overcommit. Utilisé pour les paramètres keep_free_space_*_ratio
  • check_cache_probability (Float64) — Fonctionne uniquement avec un build de Débogage ou un sanitizer. Vérifie l’intégrité du cache en le parcourant entièrement et en contrôlant l’état de chaque élément du cache
  • expose_prometheus_eviction_metrics (UInt8) — Expose les métriques Prometheus relatives à l’activité d’éviction du cache du système de fichiers (filesystem_cache_evictions_total etc.). Désactivé par défaut. Peut être activé ou désactivé à l’exécution via SYSTEM RELOAD CONFIG.
  • expose_prometheus_eviction_metrics_per_user (UInt8) — Expose également des métriques d’éviction par ID utilisateur. Nécessite expose_prometheus_eviction_metrics. La cardinalité augmente avec le nombre d’utilisateurs distincts effectuant des évictions.
  • is_initialized (UInt8) — Indique si le cache a été initialisé avec succès
  • current_size (UInt64) — Taille actuelle du cache
  • current_elements_num (UInt64) — Nombre actuel d’éléments du cache (segments de fichier)
Dernière modification le 23 juillet 2026