Миграция на сторонний кластер MySQL®

Чтобы перенести базу данных, развернутую в кластере Yandex Managed Service for MySQL®, на сторонний кластер MySQL®:

1. Перенесите данные.
2. Закройте старую базу данных на запись.
3. Переведите нагрузку на сторонний кластер.

Поддерживается миграция между разными версиями: например, можно перенести базы из MySQL® версии 5.7 в версию 8. При этом мажорная версия MySQL® на стороннем кластере должна быть не ниже версии на кластере Yandex Managed Service for MySQL®.

Перед началом работыПеред началом работы

Создайте кластер MySQL® любой подходящей конфигурации. При этом:

• Версия MySQL® должна быть не ниже чем на кластере-источнике.

  Перенос данных с повышением мажорной версии MySQL® возможен, но не гарантируется. Подробнее см. в документации MySQL®.

  Миграция с понижением версии MySQL® невозможна.

• Режим SQL должен быть таким же, как и на кластере-источнике.

Перенос данныхПеренос данных

1. Подготовьте базу данных кластера-источника.

2. Подготовьте базу данных кластера-приемника.

3. Создайте эндпоинты и трансфер:

   Вручную

   Terraform

   1. Создайте эндпоинт для источника:

      • Тип базы данных — MySQL.

      • Настройки подключения — Кластер Managed Service for MySQL.

        Укажите идентификатор кластера-источника.

   2. Создайте эндпоинт для приемника:

      • Тип базы данных — MySQL.

      • Настройки подключения — Пользовательская инсталляция.

        Укажите параметры подключения к кластеру-приемнику.

   3. Создайте трансфер типа Копирование и репликация, использующий созданные эндпоинты.

   4. Активируйте трансфер.

   1. Если у вас еще нет Terraform, установите его.

   2. Получите данные для аутентификации. Вы можете добавить их в переменные окружения или указать далее в файле с настройками провайдера.

   3. Настройте и инициализируйте провайдер. Чтобы не создавать конфигурационный файл с настройками провайдера вручную, скачайте его.

   4. Поместите конфигурационный файл в отдельную рабочую директорию и укажите значения параметров. Если данные для аутентификации не были добавлены в переменные окружения, укажите их в конфигурационном файле.

   5. Скачайте в ту же рабочую директорию файл конфигурации трансфера и эндпоинтов data-transfer-mmy-mysql.tf.

   6. Укажите в файле конфигурации:

      • параметры эндпоинта-источника;
      • параметры эндпоинта-приемника.

   7. Проверьте корректность файлов конфигурации Terraform с помощью команды:

      terraform validate
      

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

   8. Создайте необходимую инфраструктуру:

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

         terraform plan
         

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

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

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

            terraform apply
            

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

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

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

      Трансфер активируется автоматически после создания.

   Важно

   Избегайте любых изменений в схеме данных на кластере-источнике и кластере-приемнике во время работы трансфера. Подробнее см. в разделе Работа с базами данных во время трансфера.

4. Дождитесь перехода трансфера в статус Реплицируется.

5. Переведите кластер-источник в режим только чтение и переключите нагрузку на кластер-приемник.

6. На странице мониторинга трансфера дождитесь снижения до нуля характеристики Maximum data transfer delay. Это значит, что в кластер-приемник перенесены все изменения, произошедшие в кластере-источнике после завершения копирования данных.

7. Деактивируйте трансфер и дождитесь его перехода в статус Остановлен.

   Подробнее о статусах трансфера см. в разделе Жизненный цикл трансфера.

8. Удалите созданные эндпоинты и трансфер:

   Вручную

   Terraform

   Если вы создали эндпоинты и трансфер вручную, то:

   1. Удалите остановленный трансфер.
   2. Удалите эндпоинты для источника и приемника.

   Если вы создали эндпоинты и трансфер с помощью Terraform, то:

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

   2. Удалите конфигурационный файл data-transfer-mmy-mysql.tf.

   3. Проверьте корректность файлов конфигурации Terraform с помощью команды:

      terraform validate
      

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

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

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

         terraform plan
         

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

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

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

            terraform apply
            

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

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

      Все ресурсы, которые были описаны в конфигурационном файле data-transfer-mmy-mysql.tf, будут удалены.

См. такжеСм. также

Другие способы миграции описаны в документации Yandex Managed Service for MySQL®.