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

С помощью сервиса Data Transfer вы можете перенести данные из стороннего кластера-источника в кластер-приемник Managed Service for MySQL®.

Этот способ позволяет перенести базу целиком без остановки обслуживания пользователей. Для его использования необходимо разрешить подключение к кластеру-источнику из интернета.

Чтобы перенести базу данных из MySQL® в Managed Service for MySQL®:

1. Запустите перенос данных.
2. Завершите перенос данных.

Если созданные ресурсы вам больше не нужны, удалите их.

Запустите перенос данныхЗапустите перенос данных

1. Подготовьте кластер-источник.

2. Подготовьте инфраструктуру и запустите перенос данных:

   Вручную

   Terraform

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   6. Активируйте его.

      Важно

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

   1. Подготовьте кластер-источник.

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

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

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

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

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

      В этом файле описаны:

      • сеть;
      • подсеть;
      • группа безопасности и правило, необходимое для подключения к кластеру;
      • кластер-приемник Managed Service for MySQL®;
      • эндпоинт для источника;
      • эндпоинт для приемника;
      • трансфер.

   7. Укажите в файле data-transfer-mysql-mmy.tf:

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

      • параметры кластера-приемника, которые используются и как параметры эндпоинта-приемника:

        • target_mysql_version — версия MySQL®, она должна быть не ниже чем в кластере-источнике;
        • target_sql_mode — режим SQL, он должен быть таким же, как и в кластере-источнике;
        • target_db_name — имя базы данных;
        • target_user и target_password — имя и пароль пользователя-владельца базы данных.

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

      terraform validate
      

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

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

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

         terraform plan
         

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

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

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

            terraform apply
            

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

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

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

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

Завершите перенос данныхЗавершите перенос данных

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

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

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

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

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

Удалите созданные ресурсыУдалите созданные ресурсы

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

Реальный пример миграции базы данных MySQL® с помощью сервиса Data Transfer см. в разделе Синхронизация данных из MySQL с помощью Yandex Data Transfer.

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

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