Set up docs MCP这些设置可在 system.settings 中找到，并由 源代码 自动生成。
filesystem_cache_allow_background_download
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 25.11 | 1 | 用于控制文件系统缓存按查询在后台下载的新设置。 |
允许文件系统缓存将从远程存储读取的数据加入后台下载队列。禁用后，当前查询/会话的下载将改为在前台进行。
filesystem_cache_boundary_alignment
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 24.11 | 0 | 新增设置 |
文件系统缓存边界对齐。此设置仅适用于非磁盘读取 (例如远程表引擎 / 表函数的缓存，不适用于 MergeTree 表的存储配置) 。值 0 表示不进行对齐。
filesystem_cache_enable_background_download_during_fetch
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 24.11 | 1 | 新增设置 |
仅在 ClickHouse Cloud 中生效。锁定缓存的等待时间
filesystem_cache_enable_background_download_for_metadata_files_in_packed_storage
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 24.11 | 1 | 新设置 |
仅在 ClickHouse Cloud 中有效。锁定缓存的等待时间
filesystem_cache_max_download_size
单个查询可下载的远程文件系统缓存的最大大小
filesystem_cache_name
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 24.10 | 用于无状态表引擎或数据湖的文件系统缓存名称 |
用于无状态表引擎或数据湖的文件系统缓存名称
filesystem_cache_prefer_bigger_buffer_size
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 24.11 | 1 | 新设置 |
如果启用了文件系统缓存，则优先使用更大的缓冲区，以避免写入较小的 File 段，从而导致缓存性能下降。另一方面，启用此设置可能会增加内存占用。
filesystem_cache_reserve_space_wait_lock_timeout_milliseconds
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 24.3 | 1000 | 为文件系统缓存预留空间时锁定缓存的等待时间 |
为文件系统缓存预留空间时锁定缓存的等待时间
filesystem_cache_segments_batch_size
读取缓冲区一次可向缓存请求的单个 File 段批次大小上限。值过低会导致向缓存发起过多请求，值过高则可能减慢缓存逐出
filesystem_cache_skip_download_if_exceeds_per_query_cache_write_limit
别名: skip_download_if_exceeds_query_cache
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 24.11 | 1 | 设置 skip_download_if_exceeds_query_cache_limit 的重命名 |
如果会超过查询缓存大小，则跳过从远程文件系统下载
filesystem_cache_verbose_logging
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 26.8 | 0 | 新增设置，用于控制文件系统缓存读取缓冲区每次重新填充时的 TEST 级别日志消息；此前，只要日志级别允许，就会无条件发出这些消息。 |
每次重新填充文件系统缓存缓冲区时，发出 TEST 级别的日志消息 (读取状态、剩余待读取大小、已读取字节数) 。仅用于调试：每次读取时都会格式化这些消息，因此，对执行大量小规模缓存读取的查询启用此设置会显著增加日志开销。无论如何，这些消息仅在日志级别为 test 时可见 (请参阅 send_logs_level) 。
filesystem_cache_wait_for_concurrent_download_timeout_milliseconds
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 26.8 | 1000 | 用于限制读取等待并发查询将 File 段下载至文件系统缓存所需时长的新设置；超时后，读取将绕过缓存，而不会无限期等待。先前的值 60000 对应旧行为（在下载器上完成一次完整的 60 秒等待周期）。 |
等待并发查询下载至文件系统缓存的 File 段的最长时间。达到超时时间后，读取会绕过该范围的文件系统缓存，直接从远程存储读取；同时，并发下载会继续填充缓存。值 0 表示完全不等待：如果所需范围尚未下载，则立即绕过缓存。降低此值可限制原本会按另一查询下载进度等待的缓存命中读取的尾延迟，但会增加对远程存储的请求。