Расширение миграции Azure Cosmos DB для MongoDB для Azure Data Studio (предварительная версия)

Инструмент миграции Azure Cosmos DB для MongoDB упрощает процесс переноса рабочих нагрузок MongoDB в Azure Cosmos DB. Расширение можно использовать для выполнения следующих задач:

• Запустите сквозную оценку рабочей нагрузки и узнайте необходимые действия, необходимые для переноса рабочих нагрузок на виртуальные ядра Azure Cosmos DB для MongoDB.
• Выполните операцию миграции с выбранными базами данных и коллекциями в Azure Cosmos DB на основе виртуальных ядер для MongoDB.

Предварительные условия

• Существующая учетная запись Azure Cosmos DB на основе vCore для MongoDB.
  • Если у вас нет подписки Azure, создайте учетную запись бесплатно.
• Последняя версия Azure Data Studio.
• MongoDB под управлением версии 3.2 или более поздней.
• Добавьте исключения брандмауэра в исходную учетную запись MongoDB и в целевую учетную запись MongoDB на основе виртуальных ядер в Azure Cosmos DB, чтобы принимать подключения из глобальных центров обработки данных Azure.
• Если вы впервые используете Database Migration Service, убедитесь, что поставщик ресурсов Microsoft.DataMigration зарегистрирован в вашей подписке.

Подготовить

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

• Дополнительные сведения о планировании миграции для API для MongoDB vCore см. в разделе шаги предварительной подготовки для Azure Cosmos DB для MongoDB на основе vCore.
• Дополнительные сведения о планировании предварительной миграции для API MongoDB в регионе RU см. в разделе шагов по предварительной подготовке для Azure Cosmos DB, работающего с MongoDB в регионе RU.

Зарегистрируйте поставщика ресурсов Microsoft.DataMigration в вашей подписке

Чтобы убедиться, что поставщик ресурсов Microsoft.DataMigration зарегистрирован в подписке, выполните следующие действия.

Портал Azure:

1. Перейдите к портал Azure и перейдите к подписке.
2. В меню слева выберите поставщики ресурсов в разделе "Параметры".
3. Найдите Microsoft.DataMigration в поле поиска в верхней части.
4. Если он не зарегистрирован, выберите его и нажмите кнопку "Зарегистрировать".

Azure CLI:

1. Откройте Azure Cloud Shell или локальный терминал.
2. Выполните указанную ниже команду для регистрации поставщика ресурсов.

az provider register --namespace Microsoft.DataMigration

PowerShell.

1. Откройте Azure Cloud Shell или локальную среду PowerShell.
2. Выполните указанную ниже команду для регистрации поставщика ресурсов.

Register-AzResourceProvider -ProviderNamespace "Microsoft.DataMigration"

Установка расширения

Перед началом миграции установите расширение миграции Azure Cosmos DB для MongoDB в Azure Data Studio.

1. Откройте диспетчер расширений в Azure Data Studio. Выберите значок расширений или выберите "Расширения " в меню "Вид".

2. Введите Cosmos в строке поиска.

3. Выберите расширение Azure Cosmos DB Migration for MongoDB и просмотрите его сведения.

   

4. Выберите Установить.

Настройка параметров расширения

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

1. Перейдите к расширениям и выберите Перенос данных из Azure Cosmos DB в Mongo DB, щелкните значок параметров управления и выберите параметры расширения.

   

2. В разделе параметров этого расширения назначьте Assessment path расположение, в котором хранятся метаданные оценки. Если осталось пустым, используется расположение по умолчанию.

Подключение к источнику MongoDB

Используйте расширение в первый раз, чтобы подключиться к существующему исходному экземпляру MongoDB. Перед началом работы с этим разделом убедитесь, что у вас есть учетные данные подключения для источника.

1. Найдите значок подключений в строке меню и нажмите кнопку "Создать подключение".

   

2. В области подключения заполните следующие поля:

   	Значение
   Тип подключения	Azure Cosmos DB for MongoDB
   Строка подключения или параметры	Используйте строку подключения или параметры для вашего существующего экземпляра MongoDB.
   Группа серверов	Default
   Имя (необязательно)	Укажите уникальное имя для этого подключения.

3. Нажмите Подключиться.

4. Откройте контекстное меню для нового подключения в области "Подключения ". Затем нажмите кнопку "Управление".

   

5. Выберите Azure Cosmos DB Migration.

   

Провести оценку

Оценка проверяет текущее хранилище данных и использование MongoDB. Затем функция оценки создает полный отчет, который помогает определить необходимые действия перед переносом рабочих нагрузок в Azure Cosmos DB для MongoDB.

1. Найдите и перейдите на вкладку "Панель мониторинга". Затем выберите "Оценка и миграция баз данных".

   

2. Завершите работу мастера, чтобы предоставить сведения расширению, чтобы оно смогло выполнить оценку.

   

   1. В поле Имя оценки введите название.

   2. Выберите целевую учетную запись Azure Cosmos DB для MongoDB в раскрывающемся списке предложений.

   3. Укажите путь к логам MongoDB.

      Совет

      Это необязательное поле, однако указание пути к журналам приводит к более детализированному выводу на уровне коллекции. Если папка журнала не указана, средство использует сведения из serverStatus команды для выполнения оценки.

      Команда serverStatus возвращает использование функций только с момента последнего перезапуска, поэтому необходимо убедиться, что достаточно времени прошло с момента последнего перезапуска сервера, чтобы получить оценку, которая точно отражает фактическую рабочую нагрузку.

   4. Укажите путь к журналам оценки данных.

      Совет

      Хотя это поле является необязательным, предоставляя журналы оценки данных, можно получить более подробные сведения о рабочей нагрузке. Эти журналы получаются путем сканирования данных и чтения подробных логов. Оценка данных выполняется независимо от интерфейса командной строки перед запуском оценки миграции, а результирующий код JSON затем предоставляется здесь. Скачайте интерфейс командной строки оценки данных здесь.

   5. Выберите "Выполнить проверку" , чтобы проверить входные данные оценки.

3. После успешной проверки нажмите кнопку "Начать оценку ", чтобы выполнить оценку.

   

4. В зависимости от размера исходного сервера оценка занимает несколько минут. Дождитесь завершения оценки, прежде чем продолжить.

   

5. После завершения оценки теперь должен быть отчет об оценке.

   

6. В отчете об оценке выберите имя экземпляра, чтобы просмотреть список проблем на уровне сервера. Выберите определенную базу данных, чтобы просмотреть проблемы, применимые только к выбранной базе данных.

   

7. Выберите "Скачать отчет ", чтобы получить консолидированный скачанный отчет.

8. Изучите отчет об оценке, чтобы определить действия, необходимые для простой миграции рабочих нагрузок в Azure Cosmos DB для MongoDB. Перед переходом к следующему шагу убедитесь, что все блокирующие проблемы, сообщаемые в оценке, обрабатываются. Если есть какие-либо неразрешенные проблемы, вы можете выйти из процесса и обработать их позже. После устранения проблем вы можете вернуться и перезапустить процесс оценки и миграции.

Выполнение миграции

Теперь используйте отчет об оценке для переноса данных из исходного экземпляра MongoDB в целевую учетную запись Azure Cosmos DB для MongoDB, основанную на vCore.

1. На экране отчета об оценке выберите все базы данных, которые планируется перенести. Затем выберите Далее.

   

2. Чтобы выбрать целевую учетную запись Azure Cosmos DB для MongoDB, сначала отфильтруйте списки по подписке, а затем по группе ресурсов. Затем укажите учетные данные подключения, необходимые для подключения к учетной записи.

   

3. Выберите проверить подключение , чтобы проверить учетные данные для учетной записи Azure Cosmos DB для MongoDB. Нажмите кнопку "Далее ", чтобы перейти к сопоставлению коллекций из источника к целевому объекту.

4. Выберите «Пропустить» или «Перенести» для каждой коллекции в списке сопоставлений. Коллекции, которые уже существуют в целевом объекте, автоматически помечаются значком и задают значение Skip по умолчанию. Нажмите кнопку "Далее ", чтобы настроить службу azure Database Migration Service (DMS).

   

   Предупреждение

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

5. Выберите существующий экземпляр Azure Database Migration Service в раскрывающемся списке или нажмите кнопку "Создать" , чтобы создать новую службу миграции. Azure Database Migration Service — это служба, которая переносит данные на платформы данных Azure и из нее с помощью облачной инфраструктуры для передачи данных вместо использования локальных ресурсов.

   

6. Выберите режим миграции, наиболее подходящий для вашего варианта использования.

   • Онлайн миграция копирует данные коллекции, гарантируя, что обновления также реплицируются в процессе. Этот метод выгоден с минимальным временем простоя, что позволяет выполнять непрерывные операции для обеспечения непрерывности бизнес-процессов. Используйте этот параметр, если текущие операции имеют решающее значение, и сокращение простоя является приоритетом.
   • Автономная миграция захватывает моментальный снимок базы данных в начале, предлагая более простой и предсказуемый подход. Она хорошо работает, если допустимо использование статической копии базы данных и обновления в режиме реального времени не являются необходимыми.

1. Нажмите «Далее», чтобы просмотреть сводку по миграции. После проверки и подтверждения сведений выберите "Создать схему ", чтобы создать ресурсы в целевой учетной записи.

   

2. Нажмите кнопку "Начать миграцию ", чтобы инициировать передачу данных с помощью выбранной службы миграции.

   

3. Во всплывающем окне "Подтверждение параметров" убедитесь, что параметры брандмауэра соответствуют требованиям. Выберите ОК для подтверждения.

   

Задачи миграции данных выполняются в Azure Database Migration Service, поэтому во время миграции данных не требуется подключаться к исходным и целевым средам. Состояние обновляется на панели мониторинга с частыми интервалами

1. Отслеживайте состояние миграции на странице панели мониторинга после инициализации заданий.

   

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

Мониторинг офлайн миграций

Состояние автоматически обновляется после завершения всех задач миграции данных.

После успешного копирования данных из источника в целевой объект состояние автономной миграции указывает на успешное выполнение.

• Измените строки подключения в приложениях, чтобы они указывали на целевую учетную запись.

Мониторинг миграций через Интернет

Миграции в сети, в отличие от автономных миграций, не выполняются автоматически. Вместо этого они выполняются непрерывно, пока они не будут завершены вручную, выбрав Cutover.

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

1. Кнопка "Переключение" включена после завершения начальной загрузки данных для всех коллекций. Миграция в настоящее время находится на этапе репликации, постоянно копируя обновления из исходного экземпляра в целевой экземпляр, чтобы поддерживать его актуальность с последними изменениями.

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

3. Отслеживайте изменения репликации в таблице и подождите, пока метрика "Изменения репликации" не стабилизируется. Стабильная метрика 'Replication Changes Played' указывает, что все обновления из источника успешно копируются в целевую систему.

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

5. Вручную убедитесь, что количество строк совпадает с исходными и целевыми коллекциями.

6. Во всплывающем диалоговом окне. Выберите Complete Cutover.
   

   Примечание.

   Выполнение операции переключения без проверки синхронизации источника и целевого объекта может привести к потере данных.

7. Дождитесь изменения состояния на "Успешно".

8. Обновите строку подключения в ваших приложениях, чтобы указать целевую учетную запись.

Просмотр прошлых миграций и оценок

Часто полезно просматривать прошлые оценки и миграции. Расширение предоставляет интерфейс для просмотра сводок прошлых оценок и миграций. Расширение также предоставляет возможность просматривать подробные исторические отчеты об оценке.

1. Чтобы просмотреть прошлые миграции, перейдите на вкладку "Миграции " на панели инструментов. Список миграций содержит все миграции, инициированные на текущем компьютере. Чтобы получить дополнительные сведения, можно выбрать определенную миграцию в списке.

   

2. Чтобы просмотреть прошлые оценки, перейдите на вкладку "Оценки " на панели инструментов. Список оценок содержит все оценки, инициированные на текущем компьютере.

   

Следующий шаг