Связаться с намиПодключиться

Обновление версии ClickHouse®

Статья создана
Улучшена
Обновлена 24 июня 2024 г.

Вы можете изменить версию ClickHouse®, которую использует кластер, на любую из поддерживаемых Managed Service for ClickHouse® версий, но при этом переход с версии ниже 23.8 на версию 23.8 и выше производится поэтапно. Например, обновление версии Managed Service for ClickHouse® c 22.8 до 24.3 выполняется в такой последовательности: 22.8 → 23.3 → 23.8 → 24.3.

Об обновлениях в рамках одной версии и обслуживании хостов см. в разделе Техническое обслуживание.

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

В консоли управления откройте страницу создания или изменения кластера Managed Service for OpenSearch. Список доступен в поле Версия.

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

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

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

yc managed-clickhouse version list

Чтобы посмотреть список доступных версий, воспользуйтесь методом REST API list для ресурса Versions или вызовом gRPC API VersionsService/List.

Перед обновлением версии

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

  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 | ENVIRONMENT | VERSION |     CREATED AT      | HEALTH | STATUS  |
+----------------------+------+-------------+---------+---------------------+--------+---------+
| c9qf1kmm0ebi******** | mych | PRODUCTION  |    23.8 | 2024-06-06 10:23:22 | ALIVE  | RUNNING |
+----------------------+------+-------------+---------+---------------------+--------+---------+

  2. Обновите версию ClickHouse® для нужного кластера:

    yc managed-clickhouse cluster update --id <идентификатор_кластера> --version <версия_ClickHouse®>

    Укажите версию ClickHouse®: 23.8, 24.3, 24.4 или 24.5.

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

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

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

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

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

    Укажите версию ClickHouse®: 23.8, 24.3, 24.4 или 24.5.

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

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

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

      terraform validate

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

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

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

      terraform plan

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

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

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

        terraform apply

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

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

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

Ограничения по времени

Провайдер Terraform ограничивает время на выполнение операций с кластером Managed Service for ClickHouse®:

  • создание, в т. ч. путем восстановления из резервной копии, — 60 минут;
  • изменение — 90 минут;
  • удаление — 30 минут.

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

Как изменить эти ограничения?

Добавьте к описанию кластера блок timeouts, например:

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

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

  • Идентификатор кластера в параметре clusterId. Чтобы узнать идентификатор, получите список кластеров в каталоге.
  • Версию ClickHouse® в параметре configSpec.version: 23.8, 24.3, 24.4 или 24.5.
  • Список настроек, которые необходимо изменить (в данном случае — configSpec.version), в параметре updateMask.

Важно

Этот метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре updateMask (одной строкой через запятую).

ClickHouse® является зарегистрированным товарным знаком ClickHouse, Inc.

Предыдущая
На уровне запроса
Следующая
Остановка и запуск кластера