描述
列
cache_name(String) — 缓存名称path(String) — 缓存目录路径max_size(UInt64) — 缓存最大大小max_elements(UInt64) — 缓存元素最大数量，例如 File 段 (限制文件系统上的文件数量)max_file_segment_size(UInt64) — 单个 File 段的最大大小boundary_alignment(UInt64) — File 段对齐方式reserve_granularity(UInt64) — 为下载 File 段预留空间时，除已下载的数据大小外，至少额外预留这么多字节 (上限为 File 段大小) 。较粗的粒度可降低预留热路径上获取缓存状态锁的频率，但代价是会占用部分已预留但尚未下载的空间 (File 段完成时回收) 。值为 0 时禁用预先预留：仅按请求的确切大小预留空间。cache_on_write_operations(UInt8) — 启用直写缓存 (在 INSERT 和 MERGE 时写入缓存)cache_policy(String) — 缓存驱逐策略slru_size_ratio(Float64) — SLRU 缓存策略中受保护元素与试用元素的大小比例background_download_threads(UInt64) — 后台下载线程数。值为 0 时禁用后台下载background_download_queue_size_limit(UInt64) — 后台下载队列大小。值为 0 时禁用后台下载background_download_max_file_segment_size(UInt64) — 后台下载可下载的最大大小load_metadata_threads(UInt64) — 服务器启动时用于加载缓存元数据的最大线程数load_metadata_asynchronously(UInt8) — 启用在服务器启动时异步加载元数据keep_free_space_size_ratio(Float64) — 缓存在后台尽力维持的可用空间比例keep_free_space_elements_ratio(Float64) — 缓存在后台尽力维持的空闲元素比例keep_free_space_remove_batch(UInt64) — 后台线程为维持可用空间/元素比例而移除缓存元素时的批次大小keep_free_space_eviction_threads(UInt64) — 为在后台维持可用空间/元素比例而执行实际 File 段移除 (文件系统删除) 的线程数。单个后台线程会收集驱逐候选项并释放其优先队列条目，而这些线程则以无锁方式并行执行移除。invalidated_entries_cleanup_interval_ms(UInt64) — 后台任务清理已失效 (延迟移除) 的优先队列条目时的空闲间隔，单位为毫秒invalidated_entries_cleanup_threshold(UInt64) — 累积的已失效优先队列条目数量，达到该值时会触发后台移除invalidated_entries_cleanup_remove_batch(UInt64) — 每次后台迭代中，在单次写锁下移除的已失效优先队列条目的最大数量enable_filesystem_query_cache_limit(UInt8) — 启用对单个查询可写入缓存的最大大小的限制cache_hits_threshold(UInt64) — 已弃用设置enable_bypass_cache_with_threshold(UInt8) — 未记录。不建议使用bypass_cache_threshold(UInt64) — 未记录。不建议使用write_cache_per_user_id_directory(UInt8) — ClickHouse Cloud 内部设置allow_dynamic_cache_resize(UInt8) — 允许动态调整文件系统缓存大小dynamic_resize_lock_wait_ms(UInt64) — 跳过调整大小尝试前，获取动态调整大小排他锁的超时时间，单位为毫秒max_size_ratio_to_total_space(Float64) —max_size与磁盘总空间的比率skip_cache_on_disk_failure(UInt8) — 如果为 true，则在发生磁盘 IO 错误时静默跳过文件系统缓存操作。如果为 false (默认) ，则磁盘 IO 错误会作为启动失败向上传递。use_split_cache(UInt8) — 使用将文件分为 system/data 的缓存方式。split_cache_ratio(Float64) — 在 split_cache 中，system 分段占缓存总大小的比率。system_cache_extensions(String) — 启用use_split_cache时，被归类为 system 缓存分段的文件扩展名列表，以逗号分隔。更改后，现有缓存条目会保留其原先的分段类型，并会随时间自然驱逐。更改此设置需要重启。overcommit_eviction_evict_step(UInt64) — overcommit 驱逐策略中以字节为单位的驱逐步长。用于 keep_free_space_*_ratio 设置check_cache_probability(Float64) — 仅适用于 Debug 或 sanitizer 构建。通过遍历整个缓存并检查每个缓存元素的状态来验证缓存的正确性idle_client_ttl_sec(UInt64) — 如果非零且启用了write_cache_per_user_id_directory，则会从缓存中完全移除属于在这么多秒内未被访问的客户端 (user_id) 的所有缓存条目。客户端每次访问都会刷新计时器。默认值为 1 周。由分布式缓存服务器使用。idle_client_check_interval_sec(UInt64) — 空闲客户端驱逐任务的运行频率，单位为秒。仅当idle_client_ttl_sec非零时才有意义。0 表示自动值 (max(1, idle_client_ttl_sec / 10))。idle_client_eviction_threads(UInt64) — 用于清理空闲客户端缓存的最大线程数。仅当idle_client_ttl_sec非零时才有意义。expose_prometheus_eviction_metrics(UInt8) — 公开文件系统缓存驱逐活动的 Prometheus 指标 (如filesystem_cache_evictions_total) 。默认关闭。可在运行时通过SYSTEM RELOAD CONFIG切换。expose_prometheus_eviction_metrics_per_user(UInt8) — 额外公开按 user-id 统计的驱逐指标。需要expose_prometheus_eviction_metrics。其基数会随发生驱逐的不同用户数量增加而增长。drop_cache_threads(UInt64) — 在SYSTEM DROP FILESYSTEM CACHE中并行移除缓存键时使用的最大线程数。值为 1 表示仅由查询线程执行移除is_initialized(UInt8) — 指示缓存是否已成功初始化current_size(UInt64) — 当前缓存大小current_elements_num(UInt64) — 当前缓存元素 (File 段) 数量