настройки сервера zookeeper_*

Эти настройки настраивают сервер ClickHouse и автоматически сгенерированы на основе исходного кода ClickHouse.

zookeeper

Содержит настройки, которые позволяют ClickHouse взаимодействовать с кластером ZooKeeper. ClickHouse использует ZooKeeper для хранения метаданных реплик при работе с реплицируемыми таблицами. Если реплицируемые таблицы не используются, этот раздел параметров можно опустить. Следующие настройки можно задать с помощью под-тегов:

Setting	Description
`node`	Конечная точка ZooKeeper. Можно указать несколько конечных точек. Например: `<node index="1"><host>example_host</host><port>2181</port></node>`. Атрибут `index` задаёт порядок узлов при попытке подключения к кластеру ZooKeeper.
`operation_timeout_ms`	Максимальный тайм-аут для одной операции в миллисекундах.
`session_timeout_ms`	Максимальный тайм-аут для клиентского сеанса в миллисекундах.
`root` (optional)	`znode`, который используется как корневой для `znodes`, используемых сервером ClickHouse.
`fallback_session_lifetime.min` (optional)	Минимальное время жизни сеанса ZooKeeper на резервном узле, когда основной недоступен (load-balancing). Задаётся в секундах. По умолчанию: 3 часа.
`fallback_session_lifetime.max` (optional)	Максимальное время жизни сеанса ZooKeeper на резервном узле, когда основной недоступен (load-balancing). Задаётся в секундах. По умолчанию: 6 часов.
`identity` (optional)	Пользователь и пароль, необходимые ZooKeeper для доступа к запрошенным `znodes`.
`use_compression` (optional)	Включает сжатие в протоколе Keeper, если установлено значение `true`.
`use_xid_64` (optional)	Включает 64-битные идентификаторы транзакций. Установите `true`, чтобы включить расширенный формат идентификатора транзакции. По умолчанию: `false`.
`pass_opentelemetry_tracing_context` (optional)	Включает передачу контекста трассировки OpenTelemetry в запросы Keeper. Когда параметр включён, для операций Keeper будут создаваться спаны трассировки, что позволяет использовать распределённую трассировку между ClickHouse и Keeper. Подробнее см. в разделе Tracing ClickHouse Keeper Requests. По умолчанию: `false`.

Также доступна настройка zookeeper_load_balancing (optional), которая позволяет выбрать алгоритм выбора узла ZooKeeper:

Algorithm Name	Description
`random`	случайным образом выбирает один из узлов ZooKeeper.
`in_order`	выбирает первый узел ZooKeeper; если он недоступен, то второй, и так далее.
`nearest_hostname`	выбирает узел ZooKeeper с именем хоста, наиболее похожим на имя хоста сервера; сравнение выполняется по префиксу имени.
`hostname_levenshtein_distance`	как и nearest_hostname, но сравнивает имена хостов по расстоянию Левенштейна.
`first_or_random`	выбирает первый узел ZooKeeper; если он недоступен, случайным образом выбирает один из оставшихся узлов ZooKeeper.
`round_robin`	выбирает первый узел ZooKeeper; при переподключении выбирает следующий.

Пример конфигурации

<zookeeper>
    <node>
        <host>example1</host>
        <port>2181</port>
    </node>
    <node>
        <host>example2</host>
        <port>2181</port>
    </node>
    <session_timeout_ms>30000</session_timeout_ms>
    <operation_timeout_ms>10000</operation_timeout_ms>
    <!-- Optional. Chroot suffix. Should exist. -->
    <root>/path/to/zookeeper/node</root>
    <!-- Optional. Zookeeper digest ACL string. -->
    <identity>user:password</identity>
    <!--<zookeeper_load_balancing>random / in_order / nearest_hostname / hostname_levenshtein_distance / first_or_random / round_robin</zookeeper_load_balancing>-->
    <zookeeper_load_balancing>random</zookeeper_load_balancing>
    <!-- Optional. Enable 64-bit transaction IDs. -->
    <use_xid_64>false</use_xid_64>
    <!-- Optional. Enable OpenTelemetry tracing context propagation. -->
    <pass_opentelemetry_tracing_context>false</pass_opentelemetry_tracing_context>
</zookeeper>

См. также

zookeeper_log

Настройки системной таблицы zookeeper_log. Следующие настройки можно задать с помощью под-тегов: Следующие настройки можно задать с помощью вложенных тегов:

Настройка	Описание	По умолчанию	Примечание
`database`	Имя базы данных.
`table`	Имя системной таблицы.
`engine`	Определение движка MergeTree для системной таблицы.		Нельзя использовать, если заданы `partition_by` или `order_by`. Если не указано, по умолчанию выбирается `MergeTree`
`partition_by`	Пользовательский ключ партиционирования для системной таблицы.		Если для системной таблицы указан `engine`, параметр `partition_by` следует задавать непосредственно внутри ‘engine’
`ttl`	Задаёт TTL таблицы.		Если для системной таблицы указан `engine`, параметр `ttl` следует задавать непосредственно внутри ‘engine’
`order_by`	Пользовательский ключ сортировки для системной таблицы. Нельзя использовать, если задан `engine`.		Если для системной таблицы указан `engine`, параметр `order_by` следует задавать непосредственно внутри ‘engine’
`storage_policy`	Имя политики хранения, которую следует использовать для таблицы (необязательно).		Если для системной таблицы указан `engine`, параметр `storage_policy` следует задавать непосредственно внутри ‘engine’
`settings`	Дополнительные параметры, управляющие поведением MergeTree (необязательно).		Если для системной таблицы указан `engine`, параметр `settings` следует задавать непосредственно внутри ‘engine’
`flush_interval_milliseconds`	Интервал сброса данных из буфера в памяти в таблицу.	`7500`
`max_size_rows`	Максимальный размер журналов в строках. Когда количество журналов, не сброшенных на диск, достигает max_size, журналы сбрасываются на диск.	`1048576`
`reserved_size_rows`	Предварительно выделенный объём памяти в строках для журналов.	`8192`
`buffer_size_rows_flush_threshold`	Пороговое количество строк. Если порог достигнут, сброс журналов на диск запускается в фоновом режиме.	`max_size_rows / 2`
`flush_on_crash`	Определяет, нужно ли сбрасывать журналы на диск в случае сбоя.	`false`

Кроме того, следующая настройка на уровне сервера управляет политикой сброса по умолчанию для всех таблиц системных логов:

<default_system_log_flush_policy>
    <skip_alias_columns>true</skip_alias_columns>
</default_system_log_flush_policy>

Настройка	Описание	По умолчанию
`skip_alias_columns`	Если `true`, столбцы ALIAS исключаются из схем таблиц системных журналов. Требуется для системных журналов, использующих S3.	`false`

Пример

<clickhouse>
    <zookeeper_log>
        <database>system</database>
        <table>zookeeper_log</table>
        <flush_interval_milliseconds>7500</flush_interval_milliseconds>
        <ttl>event_date + INTERVAL 1 WEEK DELETE</ttl>
    </zookeeper_log>
</clickhouse>

Справочник по SQL

Типы данных

Движки

Функции

Форматы