filesystem_cache_allow_background_download
允许文件系统缓存将从远程存储读取的数据加入后台下载队列。禁用后,当前查询/会话的下载将改为在前台进行。filesystem_cache_boundary_alignment
文件系统缓存边界对齐。对于非磁盘读取 (例如远程表引擎 / 表函数的缓存) ,值 0 表示不进行对齐。对于磁盘读取 (例如位于带缓存磁盘上的 MergeTree 表) ,值 0 表示使用缓存配置中的boundary_alignment。
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 表示完全不等待:如果所需范围尚未下载,则立即绕过缓存。降低此值可限制原本会按另一查询下载进度等待的缓存命中读取的尾延迟,但会增加对远程存储的请求。