Настройка СУБД ClickHouse

Изменение настроек СУБД ClickHouse

Вы можете:

• изменить значение параметра;

• указать значение для незаданного параметра. Для этого удалите // перед параметром и присвойте ему значение. Например, чтобы установить максимальное время неактивности сессии — 1 час, удалите // перед параметром max_session_timeout и присвойте ему значение в секундах:

  3   max_session_timeout = 3600
• указать дополнительные параметры, с которыми можно ознакомиться в официальной документации ClickHouse.

Чтобы изменить настройки СУБД:

1. Выберите проект, в котором заказан кластер ClickHouse.
2. В главном меню портала перейдите в раздел Ресурсы → Базы данных → Managed Service for ClickHouse.
3. Нажмите на строку кластера, в котором нужно изменить настройки СУБД.

4. Перейдите на вкладку Настройки СУБД.

5. Измените значения параметров:

   Настройки кластера

   

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

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

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

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

     • "http" — отключение HTTP-интерфейса;
     • "tcp" — отключение TCP-интерфейса;
     • "interserver" — отключение межсерверного взаимодействия.
     • пустая строка, disableProtocols = "" — все протоколы включены;

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

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

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

     • 0 — выключено;
     • 1 — включено;

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

     • 4;
     • 16;

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

     • 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 — максимальный размер принимаемого сообщения в байтах, должно быть целым числом > 0. Примеры значений:

     • 1048576 — 1 МБ;
     • 1073741824 — 1 ГБ;

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

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

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

     • 0 — выключено;
     • 1 — включено;

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

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

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

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

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

     • 0.5 — 50% от RAM;

     • 1.0 — всегда отслеживать;

       Примечание

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

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

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

     • 0.0 — отключено;
     • 0.1 — 10% вероятность;
     • 1.0 — всегда отслеживать.
   Настройки пользователей

   

   • default_password_type — тип хеширования паролей по умолчанию. Примеры значений:

   • • "plaintext" — пароль хранится в открытом виде (без хеширования);
     • "sha256" — хеширование с использованием SHA-256;
     • "double_sha1" — двойное хеширование SHA-1, используется для совместимости с MySQL.
   • 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.

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

     • "custom_" — только настройки с префиксом custom_ * считаются пользовательскими;
     • "custom_,test_" — разрешены настройки с префиксами custom_ и test_.

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

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

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

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

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

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

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

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

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

     • 0 — требуются политики доступа; 
     • 1 — полный доступ без политик;

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

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

6. Нажмите на кнопку .