L’extension de migration Azure Cosmos DB for MongoDB vCore pour Azure Data Studio (aperçu)

Article
04/22/2024

L'extension de migration Azure Cosmos DB for MongoDB vous permet de migrer vos charges de travail MongoDB vers Azure Cosmos DB. Vous pouvez utiliser cette extension afin de :

Exécuter une évaluation de bout en bout sur votre charge de travail, mais aussi découvrir les actions nécessaires que vous allez devoir entreprendre pour effectuer une migration de vos charges de travail vers Azure Cosmos DB for MongoDB vCore.
Effectuer l’opération de migration avec les bases de données et collections sélectionnées vers Azure Cosmos DB for MongoDB vCore.

Important

Actuellement, cette extension ne prend pas en charge les scénarios suivants :

Migration en ligne pour Azure Cosmos DB for MongoDB vCore.
Migrations en ligne/hors connexion pour Azure Cosmos DB for MongoDB RU.

Pour plus d'informations sur les solutions alternatives pour l'API pour MongoDB vCore, voir les options de migration.

Prérequis

Un compte vCore Azure Cosmos DB for MongoDB existant.
- Si vous n’avez pas d’abonnement Azure, créez un compte gratuitement.
Dernière version d’Azure Data Studio.
MongoDB exécutant la version 3.2 ou ultérieure.

Préparer

Avant de commencer la migration, planifiez en amont et prenez certaines décisions avant d'entamer la migration réelle des données.

Pour plus d'informations sur la planification de la prémigration pour l'API pour MongoDB vCore, voir les étapes de la prémigration pour Azure Cosmos DB for MongoDB vCore,
Pour plus d'informations sur la planification de la prémigration pour l'API pour MongoDB RU, voir les étapes de la prémigration pour Azure Cosmos DB for MongoDB RU

Installer l’extension

Installez l'extension de migration Azure Cosmos DB for MongoDB dans Azure Data Studio avant de commencer votre migration.

Ouvrez le gestionnaire d’extensions dans Azure Data Studio. Sélectionnez l’icône des extensions ou l’option Extensions dans le menu Affichage.
Entrez Cosmos dans la barre de recherche.
Sélectionnez l’extension Migration Azure Cosmos DB for MongoDB et affichez ses détails.
Sélectionnez Installer.

Configurer les paramètres d’extension

Vous pouvez configurer certains paramètres d’extension après avoir installé l’extension. Cette étape est facultative. Si aucun paramètre n’est configuré explicitement, l’extension utilise les paramètres par défaut.

Accédez aux extensions et sélectionnez Migration Azure Cosmos DB for MongoDB, sélectionnez l’icône de gestion des paramètres, puis Paramètres d’extension.
Sous les paramètres de cette extension, spécifiez le Assessment path afin de modifier l’emplacement où les métadonnées d’évaluation sont stockées. Si ce champ n’est pas renseigné, l’emplacement par défaut est utilisé.

Connexion à la source MongoDB

Utilisez l'extension pour la première fois afin de vous connecter à l'instance « source » MongoDB existante. Assurez-vous que vous disposez des informations d'identification de la source avant de commencer cette section.

Localisez l’icône de connexions dans la barre de menus, et sélectionnez Nouvelle connexion.

Dans le volet Connexion, complétez les champs suivants :

	Valeur
Type de connexion	`Azure Cosmos DB for MongoDB`
Chaîne de connexion/Paramètres	Utilisez la chaîne de connexion ou les paramètres de votre instance source MongoDB existante.
Groupe de serveurs	`Default`
Nom (facultatif)	Fournissez un nom unique pour cette connexion.

Sélectionnez Se connecter.
Ouvrez le menu contextuel de la nouvelle connexion dans le volet Connexions. Sélectionnez ensuite Gérer.
Sélectionnez Migration Azure Cosmos DB.

Exécuter une évaluation

L'évaluation porte sur votre patrimoine de données MongoDB actuel et sur son utilisation. La fonction d'évaluation génère ensuite un rapport complet qui vous aide à identifier les mesures à prendre avant de migrer vos charges de travail vers Azure Cosmos DB for MongoDB.

Localisez et naviguez jusqu'à l'onglet Tableau de bord. Sélectionnez ensuite Évaluer et migrer les bases de données.
Complétez l'Assistant pour fournir des détails à l'extension afin qu'il puisse effectuer une évaluation.
1. Dans le champ Nom de l’évaluation, entrez un titre.
2. Sélectionnez le compte Azure Cosmos DB for MongoDB cible dans le menu déroulant de l'offre.
3. Indiquez le chemin d'accès aux journaux MongoDB.
  
  Conseil
  
  Il s’agit d’un champ facultatif. Fournir le chemin des journaux d’activité offre des informations plus détaillées au niveau de la collection. Lorsque le dossier des journaux n’est pas spécifié, l’outil se base sur les informations de la commande serverStatus pour l’évaluation. N’oubliez pas que la commande « serverStatus » ne rend compte que de l’utilisation des fonctionnalités depuis le dernier redémarrage du serveur. Pour obtenir une évaluation qui reflète avec précision votre charge de travail réelle, assurez-vous que le temps nécessaire s’est écoulé depuis le redémarrage du serveur le plus récent.
4. Fournissez le chemin d’accès aux journaux d’évaluation des données.
  
  Conseil
  
  Bien que ce champ reste facultatif, l’inclusion des journaux d’évaluation des données peut offrir des informations plus complètes sur la charge de travail. Ces journaux d’activité sont acquis en analysant les données et en examinant les journaux détaillés. L’évaluation des données s’exécute indépendamment en tant qu’interface de ligne de commande (CLI) avant de lancer l’évaluation de la migration, et le JSON obtenu est ensuite fourni ici. Téléchargez l’interface CLI d’évaluation des données ici.
5. Sélectionnez Exécuter la validation pour valider les entrées d’évaluation.
Une fois la validation réussie, sélectionnez Démarrer l'évaluation pour lancer l'évaluation.
En fonction de la taille de votre serveur source, l'évaluation prend quelques minutes. Attendez la fin de l'évaluation avant de continuer.
Une fois l'évaluation terminée, vous devriez disposer d'un rapport d'évaluation.
Dans le rapport d'évaluation, sélectionnez le nom de l'instance pour consulter la liste des problèmes rencontrés sur l'ensemble du serveur. Sélectionnez une base de données spécifique pour afficher les problèmes qui ne s'appliquent qu'à cette base de données.
Sélectionnez Télécharger le rapport pour obtenir un rapport consolidé téléchargeable.
Étudiez le rapport d'évaluation afin d'identifier les actions à entreprendre pour une migration transparente de vos charges de travail sur Azure Cosmos DB for MongoDB. Avant de passer à l'étape suivante, assurez-vous que tous les problèmes bloquants signalés dans l'évaluation sont traités. S'il y a des problèmes non résolus, vous pouvez quitter le processus et les traiter plus tard. Une fois les problèmes résolus, vous pouvez revenir et relancer le processus d'évaluation et de migration.

Effectuer une migration hors connexion

Maintenant, utilisez le rapport d'évaluation pour effectuer une migration hors connexion de vos données depuis votre instance source MongoDB vers votre compte cible Azure Cosmos DB for MongoDB vCore.

Dans l'écran du rapport d'évaluation, sélectionnez les bases de données que vous envisagez de migrer. Sélectionnez ensuite Suivant.
Réduisez les listes pour sélectionner le compte cible Azure Cosmos DB for MongoDB en filtrant par abonnement, puis par groupe de ressources. Fournissez ensuite les informations d'identification nécessaires pour vous connecter au compte.
Sélectionnez Tester la connexion pour valider les informations d'identification du compte Azure Cosmos DB for MongoDB. Sélectionnez Suivant pour passer au mappage des collections de la source à la cible.
Important

Actuellement, l’extension ne prend pas en charge les instances MongoDB source ou cible avec point de terminaison privé activé.
- Configurez l’instance MongoDB source pour autoriser les connexions à partir des centres de données Azure globaux.
- Ajoutez des exceptions de pare-feu au compte cible Azure Cosmos DB for MongoDB vCore pour permettre les connexions à partir de centres de données Azure globaux.
- Pour rechercher les informations relatives à la plage d’adresses IP pertinentes, téléchargez le fichier JSON à partir des plages d’adresses IP Azure globales et recherchez « AzureCloud.{Target Cosmos DB Account Region} » dans le fichier JSON.
Choisissez d’Ignorer ou de Migrer chaque collection dans la liste des mappages. Les collections qui existent déjà dans la cible sont automatiquement marquées d'une icône et réglées par défaut sur Ignorer. Sélectionnez Suivant pour configurer l’Azure Database Migration Service (DMS).

Avertissement

Si vous choisissez de Migrer une collection existante, la collection entière sera remplacée, ce qui entraînera une perte de données irrémédiable. Veuillez faire preuve de prudence lorsque vous choisissez cette option.
Choisissez une instance d’Azure Database Migration Service existante dans la liste déroulante ou sélectionnez Créer Nouveau pour créer un nouveau service de migration. L’Azure Database Migration Service est un service qui permet de migrer des données vers et depuis les plateformes de données Azure en utilisant l'infrastructure cloud pour le transfert de données, au lieu de dépendre des ressources locales.

Important

Si vous utilisez Database Migration Service pour la première fois, assurez-vous que le fournisseur de ressources Microsoft.DataMigration est inscrit dans votre abonnement.
Sélectionnez Suivant pour afficher le résumé de la migration. Une fois que vous avez examiné et confirmé les détails, sélectionnez Créer un schéma pour créer des ressources sur le compte cible.
Sélectionnez Démarrer la migration pour lancer le transfert de données à l'aide du service de migration sélectionné.
Consultez le statut de la migration sur la page du tableau de bord une fois que les tâches sont initialisées.
Sélectionnez une migration spécifique dans la liste des migrations pour afficher plus de détails. Attendez la fin de la migration avant de continuer.

Remarque

Vous n'avez pas besoin de rester connecté au service de migration ou à Azure Data Studio pendant que les tâches de migration sont exécutées à distance et de manière asynchrone. Les tâches de migration sont exécutées sur le service de migration et le statut est mis à jour sur le tableau de bord à intervalles fréquents.

Si vous avez sélectionné plus de 50 collections à migrer, la tâche de migration sera divisée en plusieurs tâches sur le service de migration, chacune contenant au maximum 50 collections.
Une fois la tâche terminée, le statut de la migration indique qu'elle a réussi.

Voir les migrations et évaluations passées

Il est souvent utile d'examiner les évaluations et les migrations passées. L'extension fournit une interface permettant de consulter les résumés des évaluations et des migrations passées. L'extension permet également de consulter des rapports d'évaluation historiques détaillés.

Pour visualiser les migrations passées, sélectionnez l'onglet Migrations dans la barre d'outils. La liste des migrations contient toutes les migrations qui ont été lancées sur l’ordinateur actuel. Vous pouvez sélectionner une migration spécifique dans la liste pour obtenir plus de détails.
Pour consulter les évaluations passées, sélectionnez l'onglet Évaluations dans la barre d'outils. La liste des évaluations contient toutes les évaluations qui ont été lancées sur l’ordinateur actuel.