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

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

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

1. Подготовьте облако к работе.
2. Подготовьте сторонний кластер MySQL®.
3. Перенесите данные.

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

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

Зарегистрируйтесь в Yandex Cloud и создайте платежный аккаунт:

1. Перейдите в консоль управления, затем войдите в Yandex Cloud или зарегистрируйтесь.
2. На странице Yandex Cloud Billing убедитесь, что у вас подключен платежный аккаунт, и он находится в статусе ACTIVE или TRIAL_ACTIVE. Если платежного аккаунта нет, создайте его и привяжите к нему облако.

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

Подробнее об облаках и каталогах.

Необходимые платные ресурсыНеобходимые платные ресурсы

В стоимость инфраструктуры для миграции входит плата за каждый трансфер: использование вычислительных ресурсов и количество переданных строк данных (тарифы Data Transfer).

Подготовьте сторонний кластер MySQL®Подготовьте сторонний кластер MySQL®

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

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

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

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

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

Перенесите данныеПеренесите данные

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

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

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

   Вручную

   Terraform

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

      • Направление — Источник.

      • Укажите имя эндпоинта.

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

      • Параметры эндпоинта:

        • Тип подключения — выберите Ручная настройка.
        • Настройки подключения — выберите Кластер Managed Service for MySQL.
        • Кластер управляемой БД — выберите кластер-источник из списка.
        • База данных — укажите имя базы данных в выбранном кластере.
        • Пользователь — укажите имя пользователя, под которым сервис Data Transfer будет подключаться к базе данных.
        • Пароль — укажите пароль пользователя.

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

      • Направление — Приёмник.

      • Укажите имя эндпоинта.

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

      • Параметры эндпоинта:

        • Тип подключения — выберите Ручная настройка.
        • Настройки подключения — выберите Пользовательская инсталляция.
        • Хост — укажите IP-адрес или FQDN хоста, к которому необходимо подключиться.
        • Порт — укажите номер порта для подключения к кластеру-приемнику.
        • База данных — укажите имя базы данных в пользовательской инсталляции.
        • Пользователь — укажите имя пользователя, под которым сервис Data Transfer будет подключаться к базе данных.
        • Пароль — укажите пароль пользователя.

   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. Деактивируйте трансфер и дождитесь его перехода в статус Остановлен.

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

Как удалить созданные ресурсыКак удалить созданные ресурсы

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

Полезные ссылкиПолезные ссылки

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