filesystem_cache_* 会话设置

ClickHouse 在 filesystem_cache_* 自动生成分组中的会话设置。

这些设置可在 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

如果会超过查询缓存大小，则跳过从远程文件系统下载

​

filesystem_cache_verbose_logging

每次重新填充文件系统缓存缓冲区时，发出 TEST 级别的日志消息 (读取状态、剩余待读取大小、已读取字节数) 。仅用于调试：每次读取时都会格式化这些消息，因此，对执行大量小规模缓存读取的查询启用此设置会显著增加日志开销。无论如何，这些消息仅在日志级别为 test 时可见 (请参阅 send_logs_level) 。

​

filesystem_cache_wait_for_concurrent_download_timeout_milliseconds

等待并发查询下载至文件系统缓存的 File 段的最长时间。达到超时时间后，读取会绕过该范围的文件系统缓存，直接从远程存储读取；同时，并发下载会继续填充缓存。值 0 表示完全不等待：如果所需范围尚未下载，则立即绕过缓存。降低此值可限制原本会按另一查询下载进度等待的缓存命中读取的尾延迟，但会增加对远程存储的请求。