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

Статья
04/19/2024

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

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

Внимание

В настоящее время это расширение не поддерживает следующие сценарии:

Миграция через Интернет для Azure Cosmos DB для виртуальных ядер MongoDB.
Миграции в сети и автономном режиме для Azure Cosmos DB для MongoDB RU.

Дополнительные сведения о альтернативных решениях для API для виртуальных ядер MongoDB см. в параметрах миграции.

Необходимые компоненты

Существующая учетная запись виртуального ядра Azure Cosmos DB для MongoDB.
- Если у вас нет подписки Azure, создайте учетную запись бесплатно.
Последняя версия Azure Data Studio.
MongoDB под управлением версии 3.2 или более поздней.

Подготовить

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

Дополнительные сведения о планировании предварительной подготовки для API для виртуальных ядер MongoDB см. в шагах по предварительной подготовке для виртуальных ядер MongoDB для Azure Cosmos DB.
Дополнительные сведения о планировании предварительной миграции для API для MongoDB RU см. в шагах по предварительной подготовке для Azure Cosmos DB для MongoDB RU

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

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

Откройте диспетчер расширений в Azure Data Studio. Выберите значок расширений или выберите "Расширения " в меню "Вид".
Введите Cosmos в строке поиска.
Выберите расширение Перенос данных из Azure Cosmos DB в Mongo DB и просмотрите его сведения.
Выберите Установить.

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

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

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

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

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

Найдите значок подключений в строке меню и выберите "Создать Подключение".

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

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

Нажмите Подключиться.
Откройте контекстное меню для нового подключения в области Подключение ions. Затем нажмите кнопку "Управление".
Выберите миграцию Azure Cosmos DB.

Запуск оценки

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

Найдите и перейдите на вкладку "Панель мониторинга". Затем выберите "Оценка и миграция баз данных".
Завершите работу мастера, чтобы предоставить сведения о расширении, чтобы он смог выполнить оценку.
1. В поле Имя оценки введите название.
2. Выберите целевую учетную запись Azure Cosmos DB для MongoDB в раскрывающемся списке предложения .
3. Укажите путь к журналам MongoDB.
  
  Совет
  
  Это необязательное поле, при условии, что путь к журналам дает более подробные сведения на уровне коллекции. Если папка журнала не указана, средство полагается на информацию из serverStatus команды для оценки. Помните, что команда serverStatus сообщает об использовании функций только после последнего перезапуска сервера. Чтобы получить оценку, которая точно отражает фактическую рабочую нагрузку, убедитесь, что достаточно времени истекло с момента последнего перезапуска сервера.
4. Укажите путь к журналам оценки данных.
  
  Совет
  
  Хотя это поле остается необязательным, включая журналы оценки данных, могут предложить более подробную информацию о рабочей нагрузке. Эти журналы получаются путем сканирования данных и просмотра подробных журналов. Оценка данных выполняется независимо как интерфейс командной строки (CLI), прежде чем инициировать оценку миграции, а результирующий код JSON будет предоставлен здесь. Скачайте интерфейс командной строки оценки данных здесь.
5. Выберите "Выполнить проверку" , чтобы проверить входные данные оценки.
После успешной проверки нажмите кнопку "Начать оценку ", чтобы выполнить оценку.
В зависимости от размера исходного сервера оценка занимает несколько минут. Дождитесь завершения оценки, прежде чем продолжить.
После завершения оценки теперь должен быть отчет об оценке.
В отчете об оценке выберите имя экземпляра, чтобы просмотреть список проблем на уровне сервера. Выберите определенную базу данных, чтобы просмотреть проблемы, применимые только к выбранной базе данных.
Выберите "Скачать отчет ", чтобы получить консолидированный скачанный отчет.
Изучите отчет об оценке, чтобы определить действия, необходимые для простой миграции рабочих нагрузок в Azure Cosmos DB для MongoDB. Перед переходом к следующему шагу убедитесь, что все блокирующие проблемы, сообщаемые в оценке, обрабатываются. Если есть какие-либо неразрешенные проблемы, вы можете выйти из процесса и обработать их позже. После устранения проблем вы можете вернуться и перезапустить процесс оценки и миграции.

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

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

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

В настоящее время расширение не поддерживает исходные или целевые экземпляры MongoDB с поддержкой частной конечной точки.
- Настройте исходный экземпляр MongoDB, чтобы разрешить подключения из глобальных центров обработки данных Azure.
- Добавьте исключения брандмауэра в целевую учетную запись целевой учетной записи Azure Cosmos DB для виртуальных ядер MongoDB, чтобы разрешить подключения из глобальных центров обработки данных Azure.
- Чтобы найти соответствующие сведения о диапазоне IP-адресов, скачайте JSON из глобальных диапазонов IP-адресов Azure и найдите "AzureCloud.{ Целевой регион учетной записи Cosmos DB}" в json-файле.
Выберите "Пропустить" или "Перенести" для каждой коллекции в списке сопоставлений. Коллекции, которые уже существуют в целевом объекте, автоматически помечаются значком и задают значение Skip по умолчанию. Нажмите кнопку "Далее ", чтобы настроить службу azure Database Migration Service (DMS).

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

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

Внимание

Если вы впервые используете Database Migration Service, убедитесь, что поставщик ресурсов Microsoft.DataMigration зарегистрирован в вашей подписке.
Нажмите кнопку "Рядом ", чтобы просмотреть сводку по миграции. После проверки и подтверждения сведений выберите "Создать схему ", чтобы создать ресурсы в целевой учетной записи.
Нажмите кнопку "Начать миграцию ", чтобы инициировать передачу данных с помощью выбранной службы миграции.
Просмотр состояния миграции на странице панели мониторинга после инициализации заданий.
Выберите конкретную миграцию из списка миграций, чтобы просмотреть дополнительные сведения. Дождитесь завершения миграции, прежде чем продолжить.

Примечание.

Вы не должны оставаться подключенными к службе миграции или Azure Data Studio, пока задания миграции выполняются удаленно и асинхронно. Задания миграции выполняются в службе миграции, а состояние будет обновляться на панели мониторинга с частыми интервалами.

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

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

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

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