Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

настройки сеанса distributed_cache_*

Эти настройки доступны в system.settings и автоматически генерируются на основе исходного кода.

distributed_cache_alignment

Только в ClickHouse Cloud
Тип
UInt64
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
25.70distributed_cache_read_alignment переименован в distributed_cache_alignment

Действует только в ClickHouse Cloud. Этот параметр предназначен для тестирования; не изменяйте его.

distributed_cache_bypass_connection_pool

Только в ClickHouse Cloud
Тип
Bool
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
24.100Настройка для ClickHouse Cloud

Действует только в ClickHouse Cloud. Позволяет обходить пул соединений Distributed Cache

distributed_cache_client_id

Только в ClickHouse Cloud
История версий
ВерсияЗначение по умолчаниюКомментарий
26.9Новая настройка (только для CI-тестов), позволяющая переопределить идентификатор клиента распределённого кэша для каждого запроса.
26.8Новая настройка (только для CI-тестов), позволяющая переопределить идентификатор клиента распределённого кэша для каждого запроса.

Действует только в ClickHouse Cloud. Настройка используется только для CI-тестов: если она не пуста, то переопределяет настроенный в реестре идентификатор клиента распределённого кэша для запросов данного запроса. Позволяет тестам распределять данные по ограниченному набору идентификаторов клиентов, сохраняя одни и те же данные за одним и тем же идентификатором клиента. Требует включения ci_mode в конфигурации клиента распределённого кэша: если он не включён (что используется по умолчанию, в том числе в продакшне), запрос, выполняющий чтение или запись через распределённый кэш, завершается с ошибкой SUPPORT_IS_DISABLED вместо незаметного возврата к настроенному идентификатору клиента. Запросы, которые никогда не обращаются к распределённому кэшу, не затрагиваются, поэтому значение для них игнорируется.

distributed_cache_connect_backoff_max_ms

Только в ClickHouse Cloud
Тип
UInt64
По умолчанию
50
История версий
ВерсияЗначение по умолчаниюКомментарий
25.850новая настройка

Действует только в ClickHouse Cloud. Максимальная задержка в миллисекундах при установлении соединения с distributed cache.

distributed_cache_connect_backoff_min_ms

Только в ClickHouse Cloud
Тип
UInt64
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
25.80новая настройка

Действует только в ClickHouse Cloud. Минимальная задержка в миллисекундах при создании соединения с распределённым кэшем.

distributed_cache_connect_max_tries

Только в ClickHouse Cloud
Тип
UInt64
По умолчанию
5
История версий
ВерсияЗначение по умолчаниюКомментарий
25.85Изменено значение настройки
25.120Только в ClickHouse Cloud
24.1020Настройка для ClickHouse Cloud

Действует только в ClickHouse Cloud. Количество попыток подключения к distributed cache в случае неудачного подключения

distributed_cache_connect_timeout_ms

Только в ClickHouse Cloud
Тип
UInt64
По умолчанию
50
История версий
ВерсияЗначение по умолчаниюКомментарий
25.1050новая настройка

Действует только в ClickHouse Cloud. Тайм-аут при подключении к серверу distributed cache.

distributed_cache_credentials_refresh_period_seconds

Только в ClickHouse Cloud
Тип
UInt64
По умолчанию
5
История версий
ВерсияЗначение по умолчаниюКомментарий
25.65Новый приватный параметр

Действует только в ClickHouse Cloud. Период обновления учетных данных.

distributed_cache_data_packet_ack_window

Только в ClickHouse Cloud
Тип
UInt64
По умолчанию
5
История версий
ВерсияЗначение по умолчаниюКомментарий
24.105Параметр для ClickHouse Cloud

Действует только в ClickHouse Cloud. Окно отправки ACK для последовательности DataPacket в одном запросе на чтение из распределённого кэша

distributed_cache_discard_connection_if_unread_data

Только в ClickHouse Cloud
Тип
Bool
По умолчанию
1
История версий
ВерсияЗначение по умолчаниюКомментарий
24.111Новая настройка
24.101Новая настройка

Действует только в ClickHouse Cloud. Закрывает соединение, если часть данных не была прочитана.

distributed_cache_fetch_metrics_only_from_current_az

Только в ClickHouse Cloud
Тип
Bool
По умолчанию
1
История версий
ВерсияЗначение по умолчаниюКомментарий
24.101Настройка для ClickHouse Cloud

Действует только в ClickHouse Cloud. Получать метрики только из текущей зоны доступности в system.distributed_cache_metrics, system.distributed_cache_events

distributed_cache_file_cache_name

Только в ClickHouse Cloud
История версий
ВерсияЗначение по умолчаниюКомментарий
26.1Новая настройка

Действует только в ClickHouse Cloud. Настройка, используемая только для CI-тестов: имя файлового кэша, используемого для distributed cache.

distributed_cache_log_mode

Только в ClickHouse Cloud
Тип
DistributedCacheLogMode
По умолчанию
on_error
История версий
ВерсияЗначение по умолчаниюКомментарий
24.10on_errorНастройка для ClickHouse Cloud

Действует только в ClickHouse Cloud. Режим записи в system.distributed_cache_log

distributed_cache_max_unacked_inflight_packets

Только в ClickHouse Cloud
Тип
UInt64
По умолчанию
10
История версий
ВерсияЗначение по умолчаниюКомментарий
24.1010Настройка для ClickHouse Cloud

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

distributed_cache_min_bytes_for_seek

Только в ClickHouse Cloud
Тип
UInt64
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
25.10Новый приватный параметр.

Имеет эффект только в ClickHouse Cloud. Минимальное количество байт, при котором выполняется seek в distributed cache.

distributed_cache_min_inflight_bytes_to_discard_connection_on_seek

Только в ClickHouse Cloud
Тип
UInt64
По умолчанию
4194304
История версий
ВерсияЗначение по умолчаниюКомментарий
26.94194304Новая настройка для закрытия и повторного открытия соединения с распределённым кэшем при операции seek, если иначе пришлось бы отбросить слишком много байтов, находящихся в обработке. По умолчанию — 4 MiB; значение 0 восстанавливает прежнее поведение (всегда повторно использовать соединение через идентификатор диапазона чтения).
26.84194304Новая настройка для закрытия и повторного открытия соединения с распределённым кэшем при операции seek, если иначе пришлось бы отбросить слишком много байтов, находящихся в обработке. По умолчанию — 4 MiB; значение 0 восстанавливает прежнее поведение (всегда повторно использовать соединение через идентификатор диапазона чтения).
26.74194304Новая настройка для закрытия и повторного открытия соединения с распределённым кэшем при операции seek, если иначе пришлось бы отбросить слишком много байтов, находящихся в обработке. По умолчанию — 4 MiB; значение 0 восстанавливает прежнее поведение (всегда повторно использовать соединение через идентификатор диапазона чтения).

Действует только в ClickHouse Cloud. Если при операции seek от текущей позиции открытого потока распределённого кэша расчётное количество байтов, находящихся в обработке и подлежащих отбрасыванию для дальнейшего повторного использования соединения (через механизм идентификатора диапазона чтения), превышает это значение, соединение закрывается и вместо него открывается новое. Это позволяет избежать сброса большого объёма неиспользуемых данных при частых операциях seek. Значение 0 отключает это поведение и всегда повторно использует соединение.

distributed_cache_pool_behaviour_on_limit

Только в ClickHouse Cloud
Тип
DistributedCachePoolBehaviourOnLimit
По умолчанию
wait
История версий
ВерсияЗначение по умолчаниюКомментарий
25.1waitТолько в ClickHouse Cloud
24.10allocate_bypassing_poolНастройка для ClickHouse Cloud

Действует только в ClickHouse Cloud. Определяет поведение соединения distributed cache при достижении лимита пула

distributed_cache_prefer_bigger_buffer_size

Только в ClickHouse Cloud
Тип
Bool
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
25.100Новая настройка.

Действует только в ClickHouse Cloud. То же, что и filesystem_cache_prefer_bigger_buffer_size, но для распределённого кеша.

distributed_cache_read_only_from_current_az

Только в ClickHouse Cloud
Тип
Bool
По умолчанию
1
История версий
ВерсияЗначение по умолчаниюКомментарий
25.51новая настройка

Действует только в ClickHouse Cloud. Разрешает чтение только из текущей availability zone. Если отключено, чтение будет выполняться со всех серверов кэша во всех availability zone.

distributed_cache_read_request_max_tries

Только в ClickHouse Cloud
Тип
UInt64
По умолчанию
10
История версий
ВерсияЗначение по умолчаниюКомментарий
25.810Изменено значение настройки
25.420Новая настройка

Действует только в ClickHouse Cloud. Количество повторных попыток выполнить запрос на чтение из распределённого кэша в случае неудачи

distributed_cache_receive_response_wait_milliseconds

Только в ClickHouse Cloud
Тип
UInt64
По умолчанию
60000
История версий
ВерсияЗначение по умолчаниюКомментарий
24.1060000Настройка для ClickHouse Cloud

Действует только в ClickHouse Cloud. Время ожидания в миллисекундах при получении данных по запросу из distributed cache

distributed_cache_receive_timeout_milliseconds

Только в ClickHouse Cloud
Тип
UInt64
По умолчанию
10000
История версий
ВерсияЗначение по умолчаниюКомментарий
24.1010000Параметр для ClickHouse Cloud

Действует только в ClickHouse Cloud. Время ожидания в миллисекундах при получении любого ответа от distributed cache

Значение по умолчанию в Cloud: 20000.

distributed_cache_receive_timeout_ms

Только в ClickHouse Cloud
Тип
UInt64
По умолчанию
3000
История версий
ВерсияЗначение по умолчаниюКомментарий
25.103000Новая настройка

Действует только в ClickHouse Cloud. Тайм-аут при получении данных с сервера distributed cache, в миллисекундах. Если в течение этого интервала не был получен ни один байт, генерируется исключение.

distributed_cache_registry_show_certificate_and_signature

Только в ClickHouse Cloud
Тип
Bool
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
26.60Новая настройка для отображения столбцов `certificate` и `signature` в `system.distributed_cache_registry`.

Действует только в ClickHouse Cloud. Показывает столбцы certificate и signature в таблице system.distributed_cache_registry. По умолчанию эти столбцы пусты, чтобы вывод оставался компактным; включите эту настройку, чтобы просматривать их.

distributed_cache_send_timeout_ms

Только в ClickHouse Cloud
Тип
UInt64
По умолчанию
3000
История версий
ВерсияЗначение по умолчаниюКомментарий
25.10новая настройка

Действует только в ClickHouse Cloud. Тайм-аут отправки данных на сервер распределённого кэша в миллисекундах. Если клиенту нужно отправить данные, но за этот интервал не удаётся отправить ни одного байта, генерируется исключение.

distributed_cache_tcp_keep_alive_timeout_ms

Только в ClickHouse Cloud
Тип
UInt64
По умолчанию
2900
История версий
ВерсияЗначение по умолчаниюКомментарий
25.102900новая настройка

Действует только в ClickHouse Cloud. Время в миллисекундах, в течение которого соединение с сервером Distributed Cache должно оставаться бездействующим, прежде чем TCP начнёт отправлять keepalive-пакеты.

distributed_cache_throw_on_error

Только в ClickHouse Cloud
Тип
Bool
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
24.100Настройка для ClickHouse Cloud

Действует только в ClickHouse Cloud. Повторно генерирует исключение, возникшее при взаимодействии с distributed cache, или исключение, полученное от distributed cache. В противном случае при ошибке используется резервный вариант — пропуск distributed cache

distributed_cache_use_clients_cache_for_read

Только в ClickHouse Cloud
Тип
Bool
По умолчанию
1
История версий
ВерсияЗначение по умолчаниюКомментарий
25.121новая настройка

Действует только в ClickHouse Cloud. Использовать клиентский кэш для запросов на чтение.

distributed_cache_wait_connection_from_pool_milliseconds

Только в ClickHouse Cloud
Тип
UInt64
По умолчанию
100
История версий
ВерсияЗначение по умолчаниюКомментарий
24.10100Настройка для ClickHouse Cloud

Действует только в ClickHouse Cloud. Время ожидания в миллисекундах для получения соединения из пула соединений, если для distributed_cache_pool_behaviour_on_limit задано значение wait

distributed_cache_write_request_max_tries

Только в ClickHouse Cloud
Тип
UInt64
По умолчанию
10
История версий
ВерсияЗначение по умолчаниюКомментарий
26.410Новая настройка

Действует только в ClickHouse Cloud. Количество попыток выполнить запрос записи в distributed cache в случае неудачи

Navigation