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

Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

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

1. Посмотрите полный список настроек, установленных для кластера:

   yc managed-clickhouse cluster get <имя_или_идентификатор_кластера> --full
   

2. Посмотрите описание команды CLI для изменения конфигурации кластера:

   yc managed-clickhouse cluster update-config --help
   

3. Установите нужные значения параметров:

   yc managed-clickhouse cluster update-config <имя_или_идентификатор_кластера> \
      --set <имя_параметра_1>=<значение_1>,...
   

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

1. Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

   О том, как создать такой файл, см. в разделе Создание кластера.

2. В описании кластера Managed Service for ClickHouse®, в блоке clickhouse.config, измените значения параметров:

   resource "yandex_mdb_clickhouse_cluster" "<имя_кластера>" {
     ...
     clickhouse {
       ...
   
       config {
         # Общие настройки СУБД
         ...
   
         merge_tree {
           # Настройки движка MergeTree
           ...
         }
   
         kafka {
           # Общие настройки получения данных из Apache Kafka
           ...
         }
   
         kafka_topic {
           # Настройки отдельного топика Apache Kafka
           ...
         }
   
         rabbit_mq {
           # Настройки получения данных из RabbitMQ
           username = "<имя_пользователя>"
           password = "<пароль>"
         }
   
         compression {
           # Настройки сжатия данных
           method              = "<метод_сжатия>"
           min_part_size       = <размер_куска_данных>
           min_part_size_ratio = <отношение_размеров>
         }
   
         graphite_rollup {
           # Настройки движка GraphiteMergeTree для прореживания, агрегирования и усреднения (rollup) данных Graphite.
           ...
         }
       }
       ...
     }
     ...
   }
   

   Где:

   • method — метод сжатия: LZ4 или ZSTD.
   • min_part_size — минимальный размер куска данных таблицы в байтах.
   • min_part_size_ratio — отношение размера наименьшего куска данных в таблице к полному размеру таблицы.

3. Проверьте корректность настроек.

   1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.

   2. Выполните команду:

      terraform validate
      

      Если в файлах конфигурации есть ошибки, Terraform на них укажет.

4. Подтвердите изменение ресурсов.

   1. Выполните команду для просмотра планируемых изменений:

      terraform plan
      

      Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.

   2. Если вас устраивают планируемые изменения, внесите их:

      1. Выполните команду:

         terraform apply
         

      2. Подтвердите изменение ресурсов.

      3. Дождитесь завершения операции.

Подробнее см. в документации провайдера Terraform.

resource "yandex_mdb_clickhouse_cluster" "<имя_кластера>" {
  ...
  timeouts {
    create = "1h30m" # Полтора часа
    update = "2h"    # 2 часа
    delete = "30m"   # 30 минут
  }
}

Чтобы задать настройки ClickHouse®, воспользуйтесь методом REST API update для ресурса Cluster или вызовом gRPC API ClusterService/Update и передайте в запросе:

• Идентификатор кластера в параметре clusterId. Чтобы узнать идентификатор, получите список кластеров в каталоге.
• Нужные значения в параметре configSpec.clickhouse.config.
• Список настроек, которые необходимо изменить, в параметре updateMask.