Эти настройки доступны в system.settings и автоматически генерируются на основе исходного кода.
distributed_cache_alignment
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 25.7 | 0 | distributed_cache_read_alignment переименован в distributed_cache_alignment |
Действует только в ClickHouse Cloud. Этот параметр предназначен для тестирования; не изменяйте его.
distributed_cache_bypass_connection_pool
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 24.10 | 0 | Настройка для ClickHouse Cloud |
Действует только в ClickHouse Cloud. Позволяет обходить пул соединений Distributed Cache
distributed_cache_client_id
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 26.9 | Новая настройка (только для CI-тестов), позволяющая переопределить идентификатор клиента распределённого кэша для каждого запроса. | |
| 26.8 | Новая настройка (только для CI-тестов), позволяющая переопределить идентификатор клиента распределённого кэша для каждого запроса. |
Действует только в ClickHouse Cloud. Настройка используется только для CI-тестов: если она не пуста, то переопределяет настроенный в реестре идентификатор клиента распределённого кэша для запросов данного запроса. Позволяет тестам распределять данные по ограниченному набору идентификаторов клиентов, сохраняя одни и те же данные за одним и тем же идентификатором клиента. Требует включения ci_mode в конфигурации клиента распределённого кэша: если он не включён (что используется по умолчанию, в том числе в продакшне), запрос, выполняющий чтение или запись через распределённый кэш, завершается с ошибкой SUPPORT_IS_DISABLED вместо незаметного возврата к настроенному идентификатору клиента. Запросы, которые никогда не обращаются к распределённому кэшу, не затрагиваются, поэтому значение для них игнорируется.
distributed_cache_connect_backoff_max_ms
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 25.8 | 50 | новая настройка |
Действует только в ClickHouse Cloud. Максимальная задержка в миллисекундах при установлении соединения с distributed cache.
distributed_cache_connect_backoff_min_ms
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 25.8 | 0 | новая настройка |
Действует только в ClickHouse Cloud. Минимальная задержка в миллисекундах при создании соединения с распределённым кэшем.
distributed_cache_connect_max_tries
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 25.8 | 5 | Изменено значение настройки |
| 25.1 | 20 | Только в ClickHouse Cloud |
| 24.10 | 20 | Настройка для ClickHouse Cloud |
Действует только в ClickHouse Cloud. Количество попыток подключения к distributed cache в случае неудачного подключения
distributed_cache_connect_timeout_ms
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 25.10 | 50 | новая настройка |
Действует только в ClickHouse Cloud. Тайм-аут при подключении к серверу distributed cache.
distributed_cache_credentials_refresh_period_seconds
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 25.6 | 5 | Новый приватный параметр |
Действует только в ClickHouse Cloud. Период обновления учетных данных.
distributed_cache_data_packet_ack_window
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 24.10 | 5 | Параметр для ClickHouse Cloud |
Действует только в ClickHouse Cloud. Окно отправки ACK для последовательности DataPacket в одном запросе на чтение из распределённого кэша
distributed_cache_discard_connection_if_unread_data
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 24.11 | 1 | Новая настройка |
| 24.10 | 1 | Новая настройка |
Действует только в ClickHouse Cloud. Закрывает соединение, если часть данных не была прочитана.
distributed_cache_fetch_metrics_only_from_current_az
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 24.10 | 1 | Настройка для ClickHouse Cloud |
Действует только в ClickHouse Cloud. Получать метрики только из текущей зоны доступности в system.distributed_cache_metrics, system.distributed_cache_events
distributed_cache_file_cache_name
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 26.1 | Новая настройка |
Действует только в ClickHouse Cloud. Настройка, используемая только для CI-тестов: имя файлового кэша, используемого для distributed cache.
distributed_cache_log_mode
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 24.10 | on_error | Настройка для ClickHouse Cloud |
Действует только в ClickHouse Cloud. Режим записи в system.distributed_cache_log
distributed_cache_max_unacked_inflight_packets
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 24.10 | 10 | Настройка для ClickHouse Cloud |
Действует только в ClickHouse Cloud. Максимальное число неподтверждённых пакетов, находящихся в обработке, в одном запросе на чтение из распределённого кэша
distributed_cache_min_bytes_for_seek
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 25.1 | 0 | Новый приватный параметр. |
Имеет эффект только в ClickHouse Cloud. Минимальное количество байт, при котором выполняется seek в distributed cache.
distributed_cache_min_inflight_bytes_to_discard_connection_on_seek
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 26.9 | 4194304 | Новая настройка для закрытия и повторного открытия соединения с распределённым кэшем при операции seek, если иначе пришлось бы отбросить слишком много байтов, находящихся в обработке. По умолчанию — 4 MiB; значение 0 восстанавливает прежнее поведение (всегда повторно использовать соединение через идентификатор диапазона чтения). |
| 26.8 | 4194304 | Новая настройка для закрытия и повторного открытия соединения с распределённым кэшем при операции seek, если иначе пришлось бы отбросить слишком много байтов, находящихся в обработке. По умолчанию — 4 MiB; значение 0 восстанавливает прежнее поведение (всегда повторно использовать соединение через идентификатор диапазона чтения). |
| 26.7 | 4194304 | Новая настройка для закрытия и повторного открытия соединения с распределённым кэшем при операции seek, если иначе пришлось бы отбросить слишком много байтов, находящихся в обработке. По умолчанию — 4 MiB; значение 0 восстанавливает прежнее поведение (всегда повторно использовать соединение через идентификатор диапазона чтения). |
Действует только в ClickHouse Cloud. Если при операции seek от текущей позиции открытого потока распределённого кэша расчётное количество байтов, находящихся в обработке и подлежащих отбрасыванию для дальнейшего повторного использования соединения (через механизм идентификатора диапазона чтения), превышает это значение, соединение закрывается и вместо него открывается новое. Это позволяет избежать сброса большого объёма неиспользуемых данных при частых операциях seek. Значение 0 отключает это поведение и всегда повторно использует соединение.
distributed_cache_pool_behaviour_on_limit
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 25.1 | wait | Только в ClickHouse Cloud |
| 24.10 | allocate_bypassing_pool | Настройка для ClickHouse Cloud |
Действует только в ClickHouse Cloud. Определяет поведение соединения distributed cache при достижении лимита пула
distributed_cache_prefer_bigger_buffer_size
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 25.10 | 0 | Новая настройка. |
Действует только в ClickHouse Cloud. То же, что и filesystem_cache_prefer_bigger_buffer_size, но для распределённого кеша.
distributed_cache_read_only_from_current_az
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 25.5 | 1 | новая настройка |
Действует только в ClickHouse Cloud. Разрешает чтение только из текущей availability zone. Если отключено, чтение будет выполняться со всех серверов кэша во всех availability zone.
distributed_cache_read_request_max_tries
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 25.8 | 10 | Изменено значение настройки |
| 25.4 | 20 | Новая настройка |
Действует только в ClickHouse Cloud. Количество повторных попыток выполнить запрос на чтение из распределённого кэша в случае неудачи
distributed_cache_receive_response_wait_milliseconds
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 24.10 | 60000 | Настройка для ClickHouse Cloud |
Действует только в ClickHouse Cloud. Время ожидания в миллисекундах при получении данных по запросу из distributed cache
distributed_cache_receive_timeout_milliseconds
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 24.10 | 10000 | Параметр для ClickHouse Cloud |
Действует только в ClickHouse Cloud. Время ожидания в миллисекундах при получении любого ответа от distributed cache
Значение по умолчанию в Cloud: 20000.
distributed_cache_receive_timeout_ms
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 25.10 | 3000 | Новая настройка |
Действует только в ClickHouse Cloud. Тайм-аут при получении данных с сервера distributed cache, в миллисекундах. Если в течение этого интервала не был получен ни один байт, генерируется исключение.
distributed_cache_registry_show_certificate_and_signature
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 26.6 | 0 | Новая настройка для отображения столбцов `certificate` и `signature` в `system.distributed_cache_registry`. |
Действует только в ClickHouse Cloud. Показывает столбцы certificate и signature в таблице system.distributed_cache_registry. По умолчанию эти столбцы пусты, чтобы вывод оставался компактным; включите эту настройку, чтобы просматривать их.
distributed_cache_send_timeout_ms
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 25.10 | новая настройка |
Действует только в ClickHouse Cloud. Тайм-аут отправки данных на сервер распределённого кэша в миллисекундах. Если клиенту нужно отправить данные, но за этот интервал не удаётся отправить ни одного байта, генерируется исключение.
distributed_cache_tcp_keep_alive_timeout_ms
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 25.10 | 2900 | новая настройка |
Действует только в ClickHouse Cloud. Время в миллисекундах, в течение которого соединение с сервером Distributed Cache должно оставаться бездействующим, прежде чем TCP начнёт отправлять keepalive-пакеты.
distributed_cache_throw_on_error
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 24.10 | 0 | Настройка для ClickHouse Cloud |
Действует только в ClickHouse Cloud. Повторно генерирует исключение, возникшее при взаимодействии с distributed cache, или исключение, полученное от distributed cache. В противном случае при ошибке используется резервный вариант — пропуск distributed cache
distributed_cache_use_clients_cache_for_read
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 25.12 | 1 | новая настройка |
Действует только в ClickHouse Cloud. Использовать клиентский кэш для запросов на чтение.
distributed_cache_wait_connection_from_pool_milliseconds
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 24.10 | 100 | Настройка для ClickHouse Cloud |
Действует только в ClickHouse Cloud. Время ожидания в миллисекундах для получения соединения из пула соединений, если для distributed_cache_pool_behaviour_on_limit задано значение wait
distributed_cache_write_request_max_tries
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 26.4 | 10 | Новая настройка |
Действует только в ClickHouse Cloud. Количество попыток выполнить запрос записи в distributed cache в случае неудачи