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 | новая настройка |
Использовать больший размер буфера, если включен файловый кэш, чтобы избежать записи небольших сегментов файла, которые снижают производительность кэша. Однако включение этой настройки может увеличить использование памяти.
filesystem_cache_reserve_space_wait_lock_timeout_milliseconds
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 24.3 | 1000 | Время ожидания при блокировке кэша для резервирования места в файловом кэше |
Время ожидания при блокировке кэша для резервирования места в файловом кэше
filesystem_cache_segments_batch_size
Максимальный размер одного батча сегментов файла, который буфер чтения может запрашивать из кэша. Слишком низкое значение приведёт к избыточному количеству запросов к кэшу, а слишком большое может замедлить вытеснение из кэша
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 | Новая настройка, ограничивающая время ожидания чтением сегмента файла, загружаемого в файловый кэш параллельным запросом; при тайм-ауте чтение обходит кэш вместо бесконечного ожидания. Предыдущее значение 60000 соответствует прежнему поведению (один полный 60-секундный цикл ожидания загрузчика). |
Максимальное время ожидания сегмента файла, загружаемого в файловый кэш параллельным запросом. При достижении тайм-аута чтение обходит файловый кэш для этого диапазона и считывает данные напрямую из удалённого хранилища, а параллельная загрузка продолжает заполнять кэш. Значение 0 означает не ждать вовсе: немедленно обойти кэш, если нужный диапазон ещё не загружен. Уменьшение этого значения ограничивает tail latency чтений с попаданием в кэш, которые в противном случае ожидали бы загрузки другим запросом, ценой дополнительных запросов к удалённому хранилищу.