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

Изменение версии ClickHouse

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

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

Список доступных версий

Посмотреть список доступных версий можно на экране создания или изменения кластера в консоли управления:

ch-versions

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

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

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

yc managed-clickhouse version list

Посмотреть список доступных версий можно с помощью метода API list.

Перед изменением версии

Важно

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

Перед изменением версии ClickHouse убедитесь, что это не нарушит работу ваших приложений:

  1. Посмотрите историю изменений ClickHouse и проверьте, какие из обновлений могут влиять на работу приложений.
  2. Попробуйте изменить версию на тестовом кластере (его можно развернуть, например, из резервной копии основного кластера). Обратите внимание, что при развертывании кластера из резервной копии восстановятся только таблицы на движке MergeTree.
  3. Создайте резервную копию основного кластера непосредственно перед изменением версии.

Изменить версию

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

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

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

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

  1. Получите список ваших кластеров ClickHouse:

    $ yc managed-clickhouse cluster list
+----------------------+---------------+---------------------+--------+---------+
|          ID          |     NAME      |     CREATED AT      | HEALTH | STATUS  |
+----------------------+---------------+---------------------+--------+---------+
| c9q8p8j2gaih8iti42mh | clickhouse691 | 2019-04-23 12:44:17 | ALIVE  | RUNNING |
+----------------------+---------------+---------------------+--------+---------+

  2. Получите информацию о нужном кластере и проверьте версию ClickHouse в вашем кластере, указанную в свойстве config.version:

    $ yc managed-clickhouse cluster get c9q8p8j2gaih8iti42mh
id: c9q8p8j2gaih8iti42mh
folder_id: b1gqs1teo2q2a4vnmi2t
created_at: "2019-04-23T12:44:17.929853Z"
name: clickhouse691
environment: PRODUCTION
monitoring:
- name: Console
    description: Console charts
    link: https://console.cloud.yandex.ru/folders/b1gqs1teo2q2a4vnmi2t/managed-clickhouse/cluster/c9q8p8j2gaih8iti42mh?section=monitoring
config:
    version: "19.1"
    ...

  3. Запустите изменение версии ClickHouse:

    $ yc managed-clickhouse cluster update --id c9q8p8j2gaih8iti42mh --version 19.4

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

Чтобы изменить версию ClickHouse:

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

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

  2. Добавьте к описанию кластера Managed Service for ClickHouse поле version или измените его значение, если оно уже существует:

    resource "yandex_mdb_clickhouse_cluster" "<имя кластера>" {
  ...
  version = "<версия ClickHouse>"
}

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

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

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

      terraform plan

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

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

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

      terraform apply

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

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

Изменить версию ClickHouse для кластера можно с помощью метода API update: передайте в запросе нужное значение в параметре configSpec.clickhouse.config.version.

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