Tutoriel : Migrer MongoDB vers Azure Cosmos DB for MongoDB RU à l’aide d’Azure Database Migration Service

S’APPLIQUE À : MongoDB

Important

Veuillez lire ce guide dans son intégralité avant d’effectuer les étapes de migration. Azure Database Migration Service ne prend actuellement pas en charge les migrations vers un compte Azure Cosmos DB for MongoDB vCore. Utilisez l’extension Azure Cosmos DB for MongoDB dans Azure Data Studio pour migrer vos charges de travail MongoDB hors connexion vers Azure Cosmos DB for MongoDB vCore.

Ce guide de migration de MongoDB fait partie d’une série sur la migration de MongoDB. Les étapes critiques de la migration de MongoDB sont la pré-migration, la migration proprement dite et la post-migration, comme indiqué ci-dessous.

Vue d’ensemble de la migration des données hors connexion de MongoDB vers Azure Cosmos DB avec DMS

Utilisez Azure Database Migration Service pour procéder à une migration hors connexion et ponctuelle de bases de données situées sur une instance locale ou cloud de MongoDB vers Azure Cosmos DB pour MongoDB.

Dans ce tutoriel, vous allez apprendre à :

• Créer une instance Azure Database Migration Service.
• Créer un projet de migration en utilisant Azure Database Migration Service.
• Exécuter la migration.
• Surveiller la migration.

Dans le cadre de ce tutoriel, vous allez migrer un jeu de données MongoDB hébergé sur une machine virtuelle Azure. Vous allez utiliser Azure Database Migration Service pour migrer le jeu de données vers Azure Cosmos DB pour MongoDB. Si vous n'avez pas encore configuré d'instance source de MongoDB, consultez Installer et configurer MongoDB sur une machine virtuelle Windows dans Azure.

Prérequis

Pour suivre ce didacticiel, vous devez effectuer les opérations suivantes :

• Suivez les étapes de prémigration, comme l'estimation du débit et le choix d'une clé de partition.

• Créez un compte pour Azure Cosmos DB pour MongoDB.

  Notes

  DMS n’est pas pris en charge si vous effectuez une migration vers un compte Azure Cosmos DB for MongoDB qui est provisionné en mode serverless.

• Créez un réseau virtuel Microsoft Azure pour Azure Database Migration Service à l'aide d'Azure Resource Manager. Ce modèle de déploiement fournit une connectivité de site à site à vos serveurs sources locaux par le biais d'Azure ExpressRoute ou d'un VPN. Pour plus d'informations sur la création d'un réseau virtuel, consultez la documentation relative aux réseaux virtuels Azure, en particulier les articles de « démarrage rapide » qui fournissent des informations pas à pas.

  Notes

  Pendant la configuration du réseau virtuel, si vous utilisez ExpressRoute avec le peering réseau à Microsoft, ajoutez ces points de terminaison au sous-réseau où doit être provisionné le service :

  • Point de terminaison de base de données cible (un point de terminaison SQL ou Azure Cosmos DB, par exemple)
  • Point de terminaison de stockage
  • Point de terminaison Service Bus

  Cette configuration est nécessaire car Azure Database Migration Service ne dispose pas d’une connectivité Internet.

• Vérifiez que les règles de votre groupe de sécurité de votre réseau virtuel ne bloquent pas les ports de communication suivants : 53, 443, 445, 9354 et 10000-20000. Pour plus d’informations, consultez Filtrer le trafic réseau avec les groupes de sécurité réseau.

• Ouvrez votre pare-feu Windows pour permettre à Azure Database Migration Service d’accéder au serveur MongoDB source via le port TCP 27017 (par défaut).

• Lorsque vous utilisez une appliance de pare-feu devant votre base de données source, vous pouvez être amené à ajouter des règles de pare-feu afin de permettre à Azure Database Migration Service d'accéder à la base de données source pour la migration.

Configurer la fonctionnalité Nouvelle tentative côté serveur

En migrant de MongoDB vers Azure Cosmos DB, vous pouvez bénéficier des fonctionnalités de gouvernance des ressources. Ces fonctionnalités vous permettent de tirer pleinement parti de vos RU (unités de requête) de débit approvisionnées. Azure Cosmos DB peut limiter une requête Database Migration Service au cours de la migration si celle-ci dépasse les RU approvisionnées par le conteneur. Vous devrez alors renouveler cette requête.

Database Migration Service est capable d'effectuer de nouvelles tentatives. Il est important de comprendre que le temps nécessaire aux allers-retours impliqués dans le tronçon réseau entre Database Migration Service et Azure Cosmos DB affecte le temps de réponse global de cette requête. L’amélioration du temps de réponse aux demandes limitées peut raccourcir le temps total nécessaire à la migration.

La fonctionnalité Nouvelle tentative côté serveur d'Azure Cosmos DB permet au service d'intercepter les codes d'erreur de limitation et d'effectuer une nouvelle tentative avec un temps d'aller-retour beaucoup plus court, améliorant ainsi considérablement les temps de réponse aux requêtes.

Pour utiliser la fonctionnalité Nouvelle tentative côté serveur, sur le portail Azure Cosmos DB, sélectionnez Fonctionnalités>Nouvelle tentative côté serveur.

Si la fonctionnalité est désactivée, sélectionnez Activer.

Inscrire le fournisseur de ressources

Avant de créer votre première instance Database Migration Service, vous devez inscrire le fournisseur de ressources Microsoft.DataMigration.

1. Connectez-vous au portail Azure. Recherchez et sélectionnez Abonnements.

   

2. Sélectionnez l’abonnement dans lequel vous voulez créer l’instance Azure Database Migration Service, puis sélectionnez Fournisseurs de ressources.

   

3. Recherchez « migration », puis sélectionnez Inscrire pour Microsoft.DataMigration.

   

Créer une instance

1. Dans le portail Azure, sélectionnez + Créer une ressource, recherchez Azure Database Migration Service, puis sélectionnez Azure Database Migration Service dans la liste déroulante.

   

2. Dans l’écran Azure Database Migration Service, sélectionnez Créer.

   

3. Dans Créer un service de migration, spécifiez le nom du service, l'abonnement, et un groupe de ressources nouveau ou existant.

4. Sélectionnez l’emplacement dans lequel vous souhaitez créer l’instance Azure Database Migration Service.

5. Sélectionnez un réseau virtuel existant ou créez-en un.

   Le réseau virtuel fournit à Azure Database Migration Service un accès à l’instance MongoDB source et au compte Azure Cosmos DB cible.

   Pour plus d'informations sur la création d'un réseau virtuel sur le portail Azure, consultez Créer un réseau virtuel au moyen du portail Azure.

6. Sélectionnez un niveau tarifaire.

   Pour plus d’informations sur les coûts et les niveaux de tarification, consultez la page de tarification.

   

7. Sélectionnez Créer pour créer le service.

Créer un projet de migration

Après avoir créé le service, recherchez-le sur le portail Azure, puis ouvrez-le. Créez alors un nouveau projet de migration.

1. Dans le portail Azure, sélectionnez Tous les services, recherchez Azure Database Migration Service, puis sélectionnez Azure Database Migration Services.

   

2. Dans l’écran Azure Database Migration Services, recherchez le nom de l’instance Azure Database Migration Service que vous avez créée, puis sélectionnez l’instance.

3. Sélectionnez + Nouveau projet de migration.

4. Dans Nouveau projet de migration, spécifiez le nom du projet, et dans la zone de texte Type de serveur source, sélectionnez MongoDB. Dans la zone de texte Type de serveur cible, sélectionnez Azure Cosmos DB for NoSQL, et sous Choisir un type d'activité, sélectionnez Migration de données hors connexion.

   

5. Sélectionnez Créer et exécuter une activité pour créer le projet et exécuter l’activité de migration.

Spécifier les détails de la source

1. Sur l'écran Détails de la source, spécifiez les détails de connexion du serveur MongoDB source.

   Important

   Azure Database Migration Service ne prend pas en charge Azure Cosmos DB comme source.

   Il existe trois modes de connexion à une source :

   • Mode standard, qui accepte un nom de domaine complet ou une adresse IP, un numéro de port et des informations d'identification de connexion.

   • Mode de chaîne de connexion, qui accepte une chaîne de connexion MongoDB comme décrit dans Format d'URI de la chaîne de connexion.

   • Mode de données du stockage Azure, qui accepte une URL SAP du conteneur d’objets blob. Sélectionnez L'objet blob contient des images mémoire BSON si le conteneur d'objets blob contient des images mémoire BSON produites par l'outil bsondump MongoDB. Ne sélectionnez pas cette option si le conteneur contient des fichiers JSON.

     Si vous sélectionnez cette option, vérifiez que la chaîne de connexion de compte de stockage s'affiche au format suivant :

     https://blobnameurl/container?SASKEY
     

     Vous trouverez cette chaîne de connexion SAP du conteneur d'objets blob dans l'Explorateur Stockage Azure. La création de la signature d'accès partagé du conteneur concerné fournit l'URL au format requis.

     De plus, en fonction des informations d'images mémoire de type qui se trouvent dans Stockage Azure, gardez à l'esprit ce qui suit :

     • Pour les images mémoire BSON, les données stockées dans le conteneur d'objets blob doivent être au format bsondump. Placez les fichiers de données dans des dossiers portant le nom des bases de données qui les contiennent au format collection.bson. Nommez tous les fichiers de métadonnées en utilisant le format collection.metadata.js.

     • Pour les images mémoire JSON, les fichiers présents dans le conteneur d’objets blob doivent être placés dans des dossiers nommés d’après les bases de données conteneur. Dans chaque dossier de base de données, les fichiers de données doivent être placés dans un sous-dossier appelé data et nommé en utilisant le format collection.json. Placez les fichiers de métadonnées dans un sous-dossier appelé metadata et nommé en utilisant le même format, collection.json. Les fichiers de métadonnées doivent être au même format que celui produit par l’outil de bsondump MongoDB.

   Important

   Nous vous déconseillons d'utiliser des certificats auto-signés sur le serveur MongoDB. Si vous devez en utiliser un, connectez-vous au serveur en utilisant le mode chaîne de connexion, et assurez-vous que la chaîne de connexion contient des guillemets ("").

   &sslVerifyCertificate=false
   

   Vous pouvez également utiliser l'adresse IP lorsque la résolution de noms DNS est impossible.

   

2. Cliquez sur Enregistrer.

Spécifier les détails de la cible

1. Sur l'écran Détails de la cible de migration, spécifiez les détails de connexion du compte Azure Cosmos DB cible. Ce compte correspond au compte Azure Cosmos DB pour MongoDB pré-approvisionné vers lequel vous migrez vos données MongoDB.

   

2. Cliquez sur Enregistrer.

Mapper aux bases de données cibles

1. Dans l’écran Mapper aux bases de données cibles, mappez les bases de données source et cible pour la migration.

   Si la base de données cible porte le même nom que la base de données source, Azure Database Migration Service sélectionne la base de données cible par défaut.

   Si Create apparaît en regard du nom de la base de données, cela indique qu'Azure Database Migration Service n'a pas trouvé la base de données cible et qu'il va créer la base de données pour vous.

   À ce stade de la migration, vous pouvez configurer le débit. Dans Azure Cosmos DB, vous pouvez configurer le débit au niveau de la base de données ou individuellement pour chaque collection. Le débit est mesuré en unités de requête. Apprenez-en davantage sur les tarifs d'Azure Cosmos DB.

   

2. Cliquez sur Enregistrer.

3. Sur l'écran Paramètre de collection, développez la liste des collections, puis consultez la liste des collections à migrer.

   Azure Database Migration Service sélectionne automatiquement l'ensemble des collections qui se trouvent sur l'instance source de MongoDB et qui ne se trouvent pas sur le compte Azure Cosmos DB cible. Si vous souhaitez migrer à nouveau les collections qui contiennent déjà des données, vous devez sélectionner explicitement ces collections sur ce volet.

   Vous pouvez spécifier le nombre de RU à utiliser par les collections. Azure Database Migration Service suggère des valeurs par défaut intelligentes en fonction de la taille de la collection.

   Notes

   Procédez à la migration de la base de données et à la collecte en parallèle. Si nécessaire, vous pouvez utiliser plusieurs instances d'Azure Database Migration Service pour accélérer l'exécution.

   Vous pouvez également spécifier une clé de partition afin de tirer parti du partitionnement dans Azure Cosmos DB pour une extensibilité optimale. Consultez les meilleures pratiques de sélection d'une clé de partition.

   

4. Cliquez sur Enregistrer.

5. Dans l’écran Récapitulatif de la migration, spécifiez un nom pour l’activité de migration dans la zone de texte Nom de l’activité.

   

Exécuter la migration

Sélectionnez Exécuter la migration. La fenêtre de l'activité de migration s'affiche. L'État de l'activité est Non démarré.

Surveiller la migration

Sur l'écran de l'activité de migration, sélectionnez Actualiser pour mettre à jour l'affichage jusqu'à ce que l'état de la migration soit Terminé.

Notes

Vous pouvez sélectionner l'activité pour obtenir des détails sur les métriques de migration au niveau des bases de données et des collections.

Vérifier les données dans Azure Cosmos DB

Au terme de la migration, vous pouvez consulter votre compte Azure Cosmos DB pour vérifier que toutes les collections ont bien été migrées.

Optimisation de la post-migration

Après avoir migré les données stockées dans la base de données MongoDB vers Azure Cosmos DB pour MongoDB, vous pouvez vous connecter à Azure Cosmos DB et gérer les données. Vous pouvez également effectuer d'autres étapes d'optimisation post-migration. Il peut s'agir de l'optimisation de la stratégie d'indexation, de la mise à jour du niveau de cohérence par défaut ou de la configuration de la distribution globale pour votre compte Azure Cosmos DB. Pour plus d'informations, consultez Optimisation de la post-migration.

Ressources supplémentaires

• Vous tentez d’effectuer une planification de la capacité pour une migration vers Azure Cosmos DB ?
  • Si vous ne connaissez que le nombre de vCore et de serveurs présents dans votre cluster de bases de données existant, lisez Estimation des unités de requête à l’aide de vCore ou de processeurs virtuels.
  • Si vous connaissez les taux de requêtes typiques de votre charge de travail de base de données actuelle, lisez la section concernant l’estimation des unités de requête à l’aide du planificateur de capacité Azure Cosmos DB

Étapes suivantes

Pour accéder à d'autres scénarios, lisez les instructions de migration du Guide de migration de bases de données Azure.