Подключиться
Yandex Managed Service for ClickHouse

Управление хостами кластера

Статья создана

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

Важно

Обратите внимание:

  • Чтобы добавить новые хосты в любой из шардов кластера, сначала добавьте хосты ZooKeeper, которые обеспечат отказоустойчивость кластера.
  • Если кластер использует гибридное хранилище на стадии Preview, то добавление новых хостов не поддерживается. Однако можно добавить однохостовые шарды. На стадии General Availability это ограничение будет снято.

Получить список хостов в кластере

  1. Перейдите на страницу каталога и выберите сервис Managed Service for ClickHouse.

  2. Нажмите на имя нужного кластера, затем выберите вкладку Хосты.

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

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

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

$ yc managed-clickhouse host list
     --cluster-name=<имя кластера>
     
+----------------------------+--------------+---------+--------+---------------+
|            NAME            |  CLUSTER ID  |  ROLE   | HEALTH |    ZONE ID    |
+----------------------------+--------------+---------+--------+---------------+
| rc1b...mdb.yandexcloud.net | c9qp71dk1... | MASTER  | ALIVE  | ru-central1-b |
| rc1c...mdb.yandexcloud.net | c9qp71dk1... | REPLICA | ALIVE  | ru-central1-c |
+----------------------------+--------------+---------+--------+---------------+

Имя кластера можно запросить со списком кластеров в каталоге.

Получить список хостов кластера можно с помощью метода listHosts.

Добавить хост

Количество хостов в кластерах Managed Service for ClickHouse ограничено квотами на количество CPU и объем памяти, которые доступны кластерам БД в вашем облаке. Чтобы проверить используемые ресурсы, откройте страницу Квоты и найдите блок Yandex Managed Service for ClickHouse.

  1. Перейдите на страницу каталога и нажмите плитку Managed Service for ClickHouse.

  2. Нажмите на имя нужного кластера и перейдите на вкладку Хосты.

  3. Нажмите кнопку Добавить хост.

  4. Укажите параметры хоста:

    • зону доступности;
    • подсеть (если нужной подсети в списке нет, создайте ее);
    • выберите опцию Публичный доступ, если хост должен быть доступен извне Yandex.Cloud;
    • выберите опцию Копировать схему данных, чтобы скопировать схему со случайной реплики на новый хост.

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

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

Чтобы добавить хост в кластере:

  1. Запросите список подсетей кластера, чтобы выбрать подсеть для нового хоста:

    $ yc vpc subnet list

+-----------+-----------+------------+---------------+------------------+
|     ID    |   NAME    | NETWORK ID |     ZONE      |      RANGE       |
+-----------+-----------+------------+---------------+------------------+
| b0cl69... | default-c | enp6rq7... | ru-central1-c | [172.16.0.0/20]  |
| e2lkj9... | default-b | enp6rq7... | ru-central1-b | [10.10.0.0/16]   |
| e9b0ph... | a-2       | enp6rq7... | ru-central1-a | [172.16.32.0/20] |
| e9b9v2... | default-a | enp6rq7... | ru-central1-a | [172.16.16.0/20] |
+-----------+-----------+------------+---------------+------------------+

    Если нужной подсети в списке нет, создайте ее.

  2. Посмотрите описание команды CLI для добавления хостов:

    $ yc managed-clickhouse host add --help

  3. Выполните команду добавления хоста:

    yc managed-clickhouse host add \
   --cluster-name <имя кластера> \
   --host zone-id=<зона доступности>,subnet-id=<ID подсети>,assign-public-ip=<публичный IP>,shard-name=<имя шарда>

    Чтобы скопировать схему данных со случайной реплики на новый хост, укажите необязательный параметр --copy-schema.

    Managed Service for ClickHouse запустит операцию добавления хоста.

    Идентификатор подсети необходимо указать, если в зоне доступности больше одной подсети, в противном случае Managed Service for ClickHouse автоматически выберет единственную подсеть. Имя кластера можно запросить со списком кластеров в каталоге.

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

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

  2. Добавьте к описанию кластера Managed Service for ClickHouse блок host.

    resource "yandex_mdb_clickhouse_cluster" "<имя кластера>" {
  ...
  host {
    type = "CLICKHOUSE"
    zone = "<зона доступности>"
    ...
  }
}

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

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

    2. Выполните проверку с помощью команды:

      terraform plan

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

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

    1. Если в конфигурации нет ошибок, выполните команду:

      terraform apply

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

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

Добавить хост в кластер можно с помощью метода addHosts.

Чтобы скопировать схему данных со случайной реплики на новый хост, передайте в запросе параметр copySchema со значением true.

Важно

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

Используйте опцию копирования схемы данных только в том случае, когда схема одинакова на всех хостах-репликах кластера.

Удалить хост

Вы можете удалить хост из ClickHouse-кластера, если в кластере 3 и более хостов.

  1. Перейдите на страницу каталога и нажмите плитку Managed Service for ClickHouse.

  2. Нажмите на имя нужного кластера и выберите вкладку Хосты.

  3. Нажмите значок в строке нужного хоста и выберите пункт Удалить.

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

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

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

$ yc managed-clickhouse host delete <имя хоста>
     --cluster-name=<имя кластера>

Имя хоста можно запросить со списком хостов в кластере, имя кластера — со списком кластеров в каталоге.

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

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

  2. Удалите из описания кластера Managed Service for ClickHouse блок host с типом CLICKHOUSE.

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

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

    2. Выполните проверку с помощью команды:

      terraform plan

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

  4. Подтвердите удаление ресурсов.

    1. Если в конфигурации нет ошибок, выполните команду:

      terraform apply

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

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

Удалить хост можно с помощью метода deleteHosts.

В этой статье: