Изменение настроек ClickHouse® на уровне запроса

1. Подключитесь к БД в кластере.

2. Выполните запрос:

   SELECT name, description, value FROM system.settings;
   

   Результат содержит названия, описания и значения настроек ClickHouse® на уровне запроса. Результат показывает значения для текущей сессии и пользователя, установившего эту сессию.

Чтобы задать настройки ClickHouse®:

1. В консоли управления перейдите на страницу каталога и выберите сервис Managed Service for ClickHouse.
2. Нажмите на имя нужного кластера, затем перейдите в раздел Пользователи.
3. В строке с именем нужного пользователя нажмите кнопку и выберите Настроить.
4. В списке Дополнительные настройки разверните settings и задайте настройки ClickHouse®.
5. Нажмите кнопку Сохранить изменения.

1. Подключитесь к БД в кластере под учетной записью admin.

2. Создайте пользователя:

   CREATE USER <имя_пользователя>
      IDENTIFIED WITH sha256_password BY '<пароль_пользователя>'
      SETTINGS <список_настроек_ClickHouse®>;
   

   Примечание

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

   Длина пароля от 8 до 128 символов.

   В параметре SETTINGS помимо значения настройки можно указать ее минимальное и максимальное значение. Пример для настройки idle_connection_timeout:

   CREATE USER <имя_пользователя>
      IDENTIFIED WITH sha256_password BY 'password'
      SETTINGS idle_connection_timeout = 60 MIN 5 MAX 120;
   

   Подробнее о создании пользователей см. в документации ClickHouse®.

1. Подключитесь к БД в кластере под учетной записью admin.

2. Измените учетную запись пользователя:

   ALTER USER <имя_пользователя> SETTINGS <список_настроек_ClickHouse®>;
   

   Подробнее об изменении учетных записей см. в документации ClickHouse®.

1. Подключитесь к БД в кластере под учетной записью admin.

2. Создайте профиль настроек:

   CREATE SETTINGS PROFILE <название_профиля_настроек>
      SETTINGS <список_настроек_ClickHouse®>;
   

   В параметре SETTINGS помимо значения настройки можно указать ее минимальное и максимальное значение. Пример для настройки idle_connection_timeout:

   CREATE SETTINGS PROFILE <название_профиля_настроек>
      SETTINGS idle_connection_timeout = 60 MIN 5 MAX 120;
   

   Профиль настроек можно привязать к пользователю:

   CREATE SETTINGS PROFILE <название_профиля_настроек>
      SETTINGS <список_настроек_ClickHouse®>
      TO <имя_пользователя>;
   

   Подробнее о создании профилей настроек см. в документации ClickHouse®.

1. Подключитесь к БД в кластере под учетной записью admin.

2. Измените профиль настроек:

   ALTER SETTINGS PROFILE <название_профиля_настроек>
      SETTINGS <список_настроек_ClickHouse®>;
   

   В этом запросе можно задать граничные значения настроек и привязать профиль к пользователю. Подробнее об изменении профилей настроек см. в документации ClickHouse®.

1. Подключитесь к БД в кластере.

2. Выполните запрос:

   SET <имя_пользователя> SETTINGS <список_настроек_ClickHouse®>;
   

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

3. Убедитесь, что настройки применились:

   SELECT value FROM system.settings;
   

   Чтобы посмотреть значение одной настройки, выполните запрос:

   SELECT value FROM system.settings WHERE name='<название_настройки>';
   

1. Установите зависимости, необходимые для подключения к БД.

2. Посмотрите описание команды для подключения к БД:

   clickhouse-client --help
   

   Большинство флагов в выводе команды — это расширенные настройки ClickHouse®.

3. Выберите флаги с нужными настройками. Для этого соотнесите названия флагов с названиями настроек ClickHouse®.

4. Укажите выбранные флаги в команде на подключение к БД:

   • Подключение без SSL:

     clickhouse-client --host <FQDN_любого_хоста_ClickHouse®> \
                       --user <имя_пользователя> \
                       --database <имя_БД> \
                       --port 9000 \
                       --ask-password \
                       <флаги_с_настройками_ClickHouse®>
     

   • Подключение с SSL:

     clickhouse-client --host <FQDN_любого_хоста_ClickHouse®> \
                       --secure \
                       --user <имя_пользователя> \
                       --database <имя_БД> \
                       --port 9440 \
                       --ask-password \
                       <флаги_с_настройками_ClickHouse®>
     

   • Пример подключения без SSL с настройкой idle_connection_timeout:

     clickhouse-client --host rc1a-goh2a9tr********.mdb.yandexcloud.net \
                       --user user1 \
                       --database db1 \
                       --port 9440 \
                       --ask-password \
                       --idle_connection_timeout 60
     

5. Убедитесь, что настройки применились:

   SELECT value FROM system.settings;
   

   Чтобы посмотреть значение одной настройки, выполните запрос:

   SELECT value FROM system.settings WHERE name='<название_настройки>';