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

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

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

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

yc managed-clickhouse shards add <имя нового шарда> \
   --cluster-name=<имя кластера> \
   --host zone-id=<зона доступности>,`
         `subnet-name=<имя подсети>

Где:

• <имя нового шарда> — должно быть уникальным в кластере.
  Может содержать латинские буквы, цифры, дефис и нижнее подчеркивание. Максимальная длина — 63 символа.
• --cluster-name — имя кластера.
  Имя кластера можно запросить со списком кластеров в каталоге.
• --host — параметры хоста:
  • zone-id — зона доступности.
  • subnet-name — имя подсети.

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

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

2. Добавьте к описанию кластера 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 = "<имя шарда>"
     }
   }
   

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 минут
  }
}

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

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

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

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

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

yc managed-clickhouse shards list --cluster-name=<имя кластера>

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

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

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

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

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

1. Посмотрите описание команды CLI для изменения шарда:

   yc managed-clickhouse shards update --help
   

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

   yc managed-clickhouse shards update <имя шарда> \
      --cluster-name=<имя кластера> \
      --weight=<вес шарда>
   

   Где:

   • <имя шарда> — можно запросить со списком шардов в кластере.
   • --cluster-name — имя кластера.
     Имя кластера можно запросить со списком кластеров в каталоге.
   • --weight — вес шарда. Минимальное значение — 0.

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

Воспользуйтесь методом API updateShard и передайте в запросе:

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

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

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

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

yc managed-clickhouse shards delete <имя шарда> \
   --cluster-name=<имя кластера>

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

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

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

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

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 минут
  }
}

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