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

Использовать больший размер буфера, если включен файловый кэш, чтобы избежать записи небольших сегментов файла, которые снижают производительность кэша. Однако включение этой настройки может увеличить использование памяти.

filesystem_cache_reserve_space_wait_lock_timeout_milliseconds

Время ожидания при блокировке кэша для резервирования места в файловом кэше

filesystem_cache_segments_batch_size

Максимальный размер одного батча сегментов файла, который буфер чтения может запрашивать из кэша. Слишком низкое значение приведёт к избыточному количеству запросов к кэшу, а слишком большое может замедлить вытеснение из кэша

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

Максимальное время ожидания сегмента файла, загружаемого в файловый кэш параллельным запросом. При достижении тайм-аута чтение обходит файловый кэш для этого диапазона и считывает данные напрямую из удалённого хранилища, а параллельная загрузка продолжает заполнять кэш. Значение 0 означает не ждать вовсе: немедленно обойти кэш, если нужный диапазон ещё не загружен. Уменьшение этого значения ограничивает tail latency чтений с попаданием в кэш, которые в противном случае ожидали бы загрузки другим запросом, ценой дополнительных запросов к удалённому хранилищу.
Последнее изменение 14 августа 2026 г.