Управление шардами

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

Включить шардирование
Добавить шард
Получить список шардов в кластере
Изменить шард
Удалить шард

Вы можете включить шардирование для кластера, а также добавлять и настраивать отдельные шарды.

Включить шардирование

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

Добавить шард

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

Консоль управления

Terraform

API

Перейдите на страницу каталога и выберите сервис Managed Service for ClickHouse.
Нажмите на имя нужного кластера и перейдите на вкладку Хосты.
Нажмите кнопку Добавить шард.
Укажите параметры шарда:
- имя и вес;
- чтобы скопировать схему со случайной реплики одного из шардов на хосты нового шарда, выберите опцию Копировать схему данных;
- нужное количество хостов.
Нажмите кнопку Создать шард.

Примечание

Terraform не позволяет указывать вес шардов.

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

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

Добавьте к описанию кластера Managed Service for ClickHouse блок host типа CLICKHOUSE с заполненным полем shard_name или измените существующие хосты:

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

Проверьте корректность настроек.
1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
2. Выполните команду:
```
terraform validate
```
  Если в файлах конфигурации есть ошибки, Terraform на них укажет.
Подтвердите изменение ресурсов.
1. Выполните команду для просмотра планируемых изменений:
```
terraform plan
```
  Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
2. Если вас устраивают планируемые изменения, внесите их:
  1. Выполните команду:
```
terraform apply
```
  2. Подтвердите изменение ресурсов.
  3. Дождитесь завершения операции.

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

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

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

Важно

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

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

Консоль управления

API

Перейдите на страницу каталога и выберите сервис Managed Service for ClickHouse.
Нажмите на имя нужного кластера, затем выберите вкладку Шарды.

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

Изменить шард

Вы можете изменить вес шарда, а также класс хоста и объем хранилища.

Консоль управления

CLI

API

Перейдите на страницу каталога и выберите сервис Managed Service for ClickHouse.
Нажмите на имя нужного кластера, затем выберите вкладку Шарды.
Нажмите и выберите пункт Изменить.

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

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

Чтобы изменить шард в кластере:

Посмотрите описание команды CLI для изменения шарда:
```
yc managed-clickhouse shards update --help
```

Запустите операцию, например, изменения веса для шарда:

yc managed-clickhouse shards update --cluster-name clickhouse12 \
                              --name shard1 \
                              --weight 80

После успешного завершения операции CLI выведет информацию об измененном шарде:

name: shard1
cluster_id: c9fmo2rf013t4q0ab8m1
config:
  clickhouse:
    config:
      effective_config:
        log_level: INFORMATION
  ...

  weight: "80"

Изменить настройки шарда можно с помощью метода updateShard.

Удалить шард

Вы можете удалить шард из ClickHouse-кластера, если он не является:

Единственным шардом.
Единственным шардом в группе шардов.

Удаление шарда приведет к удалению всех таблиц и данных, которые находятся на этом шарде.

Консоль управления

Terraform

API

Перейдите на страницу каталога и выберите сервис Managed Service for ClickHouse.
Нажмите на имя нужного кластера и выберите вкладку Шарды.
Нажмите значок в строке нужного хоста и выберите пункт Удалить.

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

О том, как создать такой файл, см. в разделе Создание ClickHouse-кластера.
Удалите из описания кластера Managed Service for ClickHouse блок host с описанием шарда.
Проверьте корректность настроек.
1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
2. Выполните команду:
```
terraform validate
```
  Если в файлах конфигурации есть ошибки, Terraform на них укажет.
Подтвердите удаление ресурсов.
1. Выполните команду для просмотра планируемых изменений:
```
terraform plan
```
  Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
2. Если вас устраивают планируемые изменения, внесите их:
  1. Выполните команду:
```
terraform apply
```
  2. Подтвердите изменение ресурсов.
  3. Дождитесь завершения операции.

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

Удалить шард можно с помощью метода deleteShard.

Управление шардами

Включить шардирование

Добавить шард

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

Изменить шард

Удалить шард

Была ли статья полезна?