Skip to main content
这些设置可在 system.settings 中找到,并由 源代码 自动生成。

filesystem_cache_allow_background_download

允许文件系统缓存将从远程存储读取的数据加入后台下载队列。禁用后,当前查询/会话的下载将改为在前台进行。

filesystem_cache_boundary_alignment

文件系统缓存边界对齐。此设置仅适用于非磁盘读取 (例如远程表引擎 / 表函数的缓存,不适用于 MergeTree 表的存储配置) 。值 0 表示不进行对齐。

filesystem_cache_enable_background_download_during_fetch

仅在 ClickHouse Cloud 中生效。锁定缓存的等待时间

filesystem_cache_enable_background_download_for_metadata_files_in_packed_storage

仅在 ClickHouse Cloud 中有效。锁定缓存的等待时间

filesystem_cache_max_download_size

单个查询可下载的远程文件系统缓存的最大大小

filesystem_cache_name

用于无状态表引擎或数据湖的文件系统缓存名称

filesystem_cache_prefer_bigger_buffer_size

如果启用了文件系统缓存,则优先使用更大的缓冲区,以避免写入较小的 File 段,从而导致缓存性能下降。另一方面,启用此设置可能会增加内存占用。

filesystem_cache_reserve_space_wait_lock_timeout_milliseconds

为文件系统缓存预留空间时锁定缓存的等待时间

filesystem_cache_segments_batch_size

读取缓冲区一次可向缓存请求的单个 File 段批次大小上限。值过低会导致向缓存发起过多请求,值过高则可能减慢缓存逐出

filesystem_cache_skip_download_if_exceeds_per_query_cache_write_limit

别名: skip_download_if_exceeds_query_cache 如果会超过查询缓存大小,则跳过从远程文件系统下载
最后修改于 2026年7月24日