Skip to content

Параметры кластера

Вы можете подробнее ознакомиться с настройками таблиц MergeTree и узла в официальной документации ClickHouse.

Пользовательские параметры

Пользовательские параметры Managed ClickHouse можно задавать и изменять самостоятельно.

asynchronous_metric_log

Настройки системной таблицы system.asynchronous_metrics, которая содержит метрики, вычисляемые в фоновом режиме. Например, количество используемой оперативной памяти.

  • asynchronous_metric_log.flush_interval_milliseconds

    Интервал в миллисекундах для выгрузки данных из буфера памяти.

    Применяется без перезапуска кластера.

    Значение по умолчанию: 7500.

  • asynchronous_metric_log.max_size_rows

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

    Применяется без перезапуска кластера.

    Значение по умолчанию: 1048576.

  • asynchronous_metric_log.flush_on_crash

    Записывать ли лог на диск при аварийном завершении работы.

    Применяется без перезапуска кластера.

    Значение по умолчанию: true.

  • asynchronous_metric_log.asynchronous_metrics_update_period_s

    Период обновления фоновых метрик в секундах.

    Применяется без перезапуска кластера.

    Значение по умолчанию: 120.

background_*_pool_size

Настройки пулов фоновых потоков, отвечающих за выполнение операций слияния, подгрузки данных и других фоновых задач в таблицах с движком семейства MergeTree.

  • background_common_pool_size

    Максимальное количество потоков для выполнения фоновых операций. Для применения кластер автоматически перезапустится.

    Значение по умолчанию: null.

  • background_fetches_pool_size

    Максимальное количество потоков для фоновой подгрузки данных из реплик. Для применения кластер автоматически перезапустится.

    Значение по умолчанию: 16.

  • background_pool_size

    Количество потоков для фоновых слияний и мутаций. Перед изменением параметра ознакомьтесь с параметрами number-of-free-entries-in-pool-to-execute_mutation и number-of-free-entries-in-pool-to-lower-max-size-of-merge настроек таблиц MergeTree.

    Увеличение значения применяется без перезапуска кластера. Для уменьшения значения кластер автоматически перезапустится.

    Значение по умолчанию: 16.

default_database

Имя базы данных, используемое при подключении. Тип string.

Применяется без перезапуска кластера.

Значение по умолчанию: default.

error_log

Собирать ли историю ошибок в системную таблицу system.error_log.

Значение по умолчанию: не указано (история не собирается).

Чтобы вручную включить сбор истории ошибок, создайте файл /etc/clickhouse-server/config.d/error_log.xml с конфигурацией.

logger.level

Уровень детализации логирования узла.

Применяется без перезапуска кластера.

Допустимые значения:

  • FATAL — только фатальные ошибки;
  • CRITICAL — критические ошибки;
  • ERROR — любые ошибки;
  • WARNING — предупреждения;
  • NOTICE — важные системные события;
  • INFORMATION — общая информационная диагностика;
  • DEBUG — подробная отладочная информация;
  • TRACE — максимально детальное трассирование.

Значение по умолчанию: INFORMATION.

max_connections

Максимальное количество одновременных соединений с узлом. Тип Int32.

Применяется без перезапуска кластера.

Значение по умолчанию: 1024.

metric_log

Настройки системной таблицы system.metric_log, которая содержит историю метрик.

  • metric_log.flush_interval_milliseconds

    Интервал в миллисекундах для выгрузки данных из буфера памяти.

    Применяется без перезапуска кластера.

    Значение по умолчанию: 7500.

  • metric_log.max_size_rows

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

    Применяется без перезапуска кластера.

    Значение по умолчанию: 1048576.

  • metric_log.flush_on_crash

    Записывать ли лог на диск при аварийном завершении работы.

    Применяется без перезапуска кластера.

    Значение по умолчанию: true.

query_cache

Настройки кеша запросов. Кеш запросов позволяет вычислить запросы SELECT один раз и обслуживать дальнейшие выполнения того же запроса из кеша.

  • query_cache.max_size_in_bytes

    Максимальный объем кеша запросов в байтах. Значение 0 отключает кеш.

    Применяется без перезапуска кластера.

    Значение по умолчанию: 1073741824.

  • query_cache.max_entries

    Максимальное количество результатов SELECT-запросов, хранящихся в кеше.

    Применяется без перезапуска кластера.

    Значение по умолчанию: 1024.

  • query_cache.max_entry_size_in_bytes

    Максимальный размер одного результата SELECT-запроса в байтах, который можно сохранить в кеш.

    Применяется без перезапуска кластера.

    Значение по умолчанию: 1048576.

  • query_cache.max_entry_size_in_rows

    Максимальное количество строк в одном результате SELECT-запроса, которое можно сохранить в кеш.

    Применяется без перезапуска кластера.

    Значение по умолчанию: 30000000.

trace_log

Настройки системной таблицы system.trace_log, которая записывает трассировки выполнения запросов и внутренних операций узла для диагностики производительности.

  • trace_log.flush_interval_milliseconds

    Интервал в миллисекундах для выгрузки данных из буфера памяти.

    Применяется без перезапуска кластера.

    Значение по умолчанию: 7500.

  • trace_log.max_size_rows

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

    Применяется без перезапуска кластера.

    Значение по умолчанию: 1048576.

  • trace_log.flush_on_crash

    Записывать ли лог на диск при аварийном завершении работы.

    Применяется без перезапуска кластера.

    Значение по умолчанию: true.

Внутренние параметры

Внутренние параметры Managed ClickHouse недоступны для изменения.

allow_no_password

Определяет, разрешен ли небезопасный тип аутентификации no_password — создание пользователей без пароля.

Фиксированное значение: 0 (запрещен). Отключено для повышения уровня безопасности.

min_free_disk_ratio_to_perform_insert

Минимальное соотношение свободного дискового пространства к общему для выполнения операций INSERT. Учитывает настройку keep_free_space_bytes и не учитывает объем данных, которые записываются операцией INSERT.

Фиксированное значение: 0.9.

Если указано значение параметра min_free_disk_bytes_to_perform_insert, будет применяться то значение из двух, которое требует больше свободного места.

timezone

Часовой пояс узла. Задается в формате IANA. Параметр влияет на отображение временных меток в системных таблицах.

Фиксированное значение: UTC. Зафиксирован для обеспечения согласованности логов и метрик с другими сервисами платформы.