Создание кластера ClickHouse

Координатор:

• Количество нод в кластере * — 3;

• Размер диска, ГБ * — размер выделенной памяти на каждой ноде Координатора, от 25 ГБ до 2048 ГБ;
• Тип диска *:
  • Average cluster 2 - IOPS Read: 10000 IOPS Write: 3000;
  • Average cluster 4 - IOPS Read: 10000 IOPS Write: 3000;
  • High cluster 4 - IOPS Read: 15000 IOPS Write: 5000;

  • High cluster 5 - IOPS Read: 15000 IOPS Write: 5000;

  • High cluster 6 - IOPS Read: 15000 IOPS Write: 5000.

    IOPS — операции чтения и записи. Чем больше проводится операций чтения, тем меньше операций записи, и наоборот. При выполнении операций расходуется один и тот же дисковый ресурс.

    Примечание

    Типы дисков отличаются производительностью и количеством IOPS. Подробнее см. раздел Задержка и производительность дисков.

• default_database — база данных, к которой нужно подключаться по умолчанию, если имя базы данных явно не указано в команде;

  Требования к значению

  1. База данных должна быть создана в ClickHouse. Если указана несуществующая база данных, сервер может не запуститься или запросы будут завершаться с ошибкой.
  2. Значение чувствительно к регистру. Например, mydb и MyDB — это разные базы данных.
  3. Может быть задано значение системной базы данных (например, system), если это соответствует логике использования.

• disableProtocols — отключение определённых сетевых протоколов (например, HTTP, TCP) для повышения безопасности:

  • http — отключение протокола HTTP;
  • tcp — отключение протокола TCP;
  • interserver — отключение межсерверного взаимодействия;
    

    Примечание

    По умолчанию все протоколы включены.

• max_session_timeout — максимальное время неактивности сессии (в секундах). Примеры значений:

  • 0 — без ограничения;
  • 3600 — 1 час;

• async_load_databases — асинхронная загрузка баз данных при старте сервера:

  • false — асинхронная загрузка выключена;
  • true — асинхронная загрузка включена;

• max_thread_pool_size — максимальное количество потоков в пуле для выполнения запросов. Должно быть целым числом > 0. Примеры значений: 4, 16;

• max_send_message_size — максимальный размер отправляемого сообщения в байтах. Примеры значений:

  • -1 — размер сообщений не ограничен;
  • 1048576 — 1 МБ;
  • 1073741824 — 1 ГБ;

• max_concurrent_queries — максимальное количество одновременно выполняемых запросов. Должно быть целым числом > 0. Примеры значений: 50, 500;

• default_session_timeout — время неактивности сессии по умолчанию (в секундах). Должно быть меньше либо равно значению параметра max_session_timeout. Должно быть целым числом ≥ 0. Примеры значений:

  • 0 — без ограничения;
  • 3600 — 1 час;

• max_server_memory_usage — максимальное использование оперативной памяти сервером (в байтах). Должно быть целым числом ≥ 0. Примеры значений:

  • 0 — без ограничения;
  • 34359738368 — 32 ГБ;

• uncompressed_cache_size — размер кеша для несжатых данных (в байтах). Должно быть целым числом ≥ 0. Примеры значений:

  • 0 — кеш отключен;
  • 1073741824 — 1 ГБ;

• max_receive_message_size — максимальный размер принимаемого gRPC-сообщения в байтах. Примеры значений:

  • -1 — размер сообщения не ограничен;
  • 1048576 — 1 МБ;
  • 1073741824 — 1 ГБ;

• total_memory_profiler_step — шаг для профилирования использования памяти (в байтах). Должно быть целым числом > 0. Примеры значений:

  • 4194304 — 4 МБ;
  • 67108864 — 64 МБ;

• validate_tcp_client_information — проверка информации о TCP-клиенте:

  • false — проверка выключена;
  • true — проверка включена;

• concurrent_threads_soft_limit_num — мягкое ограничение на количество одновременно работающих потоков. Должно быть целым числом ≥ 0. Примеры значений:

  • 0 — без ограничения;
  • 32;

• builtin_dictionaries_reload_interval — интервал перезагрузки встроенных словарей (в секундах). Должно быть целым числом > 0. Примеры значений:

  • 3600 — 1 час;
  • 604800 — 1 неделя;

• max_server_memory_usage_to_ram_ratio — отношение максимального использования памяти сервером к объёму оперативной памяти (RAM). Должно быть числом от 0 до 1. Примеры значений:

  • 0.5 — 50% от RAM;

  • 1.0 — 100% от RAM;

    Примечание

    Обычно значение устанавливается в диапазоне от 0.5 до 0.9, чтобы оставить часть памяти для других процессов операционной системы и избежать нехватки памяти.

    Например, если у вас 64 ГБ RAM, и вы установите значение 0.8, то ClickHouse будет использовать до 51,2 ГБ оперативной памяти.

• total_memory_tracker_sample_probability — вероятность отслеживания использования памяти. Должно быть числом от 0 до 1. Примеры значений:
  

  • 0 — отслеживание использования памяти отключено;
  • 0.1 — вероятность составляет 10%;
  • 1 — использование памяти всегда отслеживается.

• default_password_type — тип хеширования паролей по умолчанию. Примеры значений:
  
  • plaintext — пароль хранится в открытом виде (без хеширования);
  • sha256 — хеширование с использованием SHA-256;
  • double_sha1 — двойное хеширование SHA-1, используется для совместимости с MySQL;
• custom_settings_prefixes — список префиксов для пользовательских настроек. Примеры значений:
  
  • custom_ — только настройки с префиксом custom_ считаются пользовательскими;
  • custom_ test_ — только настройки с префиксами custom_ и test_ считаются пользовательскими; 
    

    Примечание

    Если параметру custom_settings_prefixes не присвоить значение, пользовательские настройки будут недоступны, кроме тех, что были явно зарегистрированы через конфигурацию сервера, роли или ограничения;

    Пример

    Если администратор добавил настройки через конфигурацию сервера или роли, например:

    <t1cloud>
     <profiles>
     <default>
     <custom_timeout>30</custom_timeout>
     <custom_retries>5</custom_retries>
     </default>
     </profiles>
    </t1cloud>

    то при // custom_settings_prefixes будут доступны только эти настройки:

    • custom_timeout — ожидание операции в секундах, после чего произойдёт ошибка или повтор операции;
    • custom_retries — количество повторов операции при сбое.

    Любые другие пользовательские настройки будут недоступны.

    
    

• table_engines_require_grant — требование привилегии CREATE для использования определённых движков таблиц:

  • false — привилегия CREATE не требуется;
  • true — привилегия CREATE требуется;

• select_from_system_db_requires_grant — требование привилегии SELECT для выполнения запросов к системным базам данных:

  • false — привилегия SELECT не требуется;
  • true — привилегия SELECT требуется;

• settings_constraints_replace_previous — замена ограничений настроек:

  • false — новые ограничения добавляются к существующим (не заменяют их);
  • true — новые ограничения заменяют существующие;

• on_cluster_queries_require_cluster_grant — требование привилегии CLUSTER для запросов ON CLUSTER:

  • false — привилегия CLUSTER не требуется;
  • true — привилегия CLUSTER требуется;

• users_without_row_policies_can_read_rows — политики доступа к строкам:

  • false — требуются политики доступа; 
  • true — полный доступ (без политик);

• select_from_information_schema_requires_grant — требование привилегии SELECT для выполнения запросов к information_schema:

  • false — привилегия SELECT не требуется;
  • true — привилегия SELECT требуется.