Tous les produits
Search
Centre de documentation

ApsaraDB for MongoDB:Migrate an ApsaraDB for MongoDB instance to another region

Dernière mise à jour :Aug 31, 2026

DTS migre une instance ApsaraDB for MongoDB (réplica ou autonome) vers une autre région. Cette opération prend en charge la migration complète des données et, pour les instances de type réplica, la migration incrémentielle des données.

Chemins de migration pris en charge

Type d'instance source Migration complète des données Migration incrémentielle des données
Instance autonome Pris en charge Non pris en charge
Instance de type réplica Pris en charge Pris en charge
Instance de type cluster fragmenté Non pris en charge. Utilisez plutôt mongodump et mongorestore. Non pris en charge

Types de migration

Type de migration Description
Migration complète des données Migre toutes les bases de données, collections et index existants de la source vers la destination.
Migration incrémentielle des données Synchronise les modifications en cours après la fin de la migration complète. Prend en charge les opérations de création et de suppression sur les bases de données, les collections et les index, ainsi que les opérations de création, de suppression et de mise à jour sur les documents.

Facturation

Type de migration Frais de configuration de la tâche Frais de trafic Internet
Migration complète des données Gratuit Facturé uniquement pour la migration via Internet depuis Alibaba Cloud. Consultez la Présentation de la facturation.
Migration incrémentielle des données Facturé. Consultez la Présentation de la facturation. Identique à la migration complète des données. Les frais de trafic Internet s'appliquent à l'ensemble de la tâche lorsque la destination utilise une adresse IP publique. Consultez les Éléments facturables.

Autorisations requises

Base de données Migration complète des données Migration incrémentielle des données
Instance source Autorisations de lecture sur la base de données source Autorisations de lecture sur les bases de données source, admin et local
Instance de destination Autorisations de lecture et d'écriture sur la base de données de destination Autorisations de lecture et d'écriture sur la base de données de destination

Pour créer et autoriser un compte de base de données, consultez la rubrique Gérer les autorisations des utilisateurs sur les bases de données MongoDB.

Prérequis

Avant de commencer, assurez-vous que :

Avant de commencer

  • La migration complète des données augmente la charge sur les deux instances. Effectuez la migration pendant les heures creuses.

  • Les instances autonomes ne prennent pas en charge la migration incrémentielle. Évitez d'écrire des données dans la source pendant la migration complète afin de garantir la cohérence des données.

  • Les écritures simultanées dans la destination consomment 5 % à 10 % d'espace de stockage supplémentaire par rapport aux données source.

  • Assurez-vous qu'il n'existe aucune clé primaire en double dans la destination (par défaut : _id). Les doublons peuvent entraîner une perte de données. Supprimez les données conflictuelles avant de démarrer la migration sans interrompre les services DTS.

  • ApsaraDB for MongoDB peut mettre à jour automatiquement la version mineure lorsqu'elle expire ou quitte la liste de maintenance, ou lors des mises à niveau de version, de la migration de données, des modifications de configuration ou de la restauration de sauvegarde.

Créer une tâche de migration

Cet exemple montre comment migrer une instance de type réplica de Chine (Qingdao) vers Chine (Hangzhou).

Migrate data between ApsaraDB for MongoDB instances across regions

Étape 1 : Démarrer la migration

  1. Connectez-vous à la console ApsaraDB for MongoDB.

  2. Dans le volet de navigation de gauche, cliquez sur Replica Set Instances ou Sharded Cluster Instances.

  3. Dans le coin supérieur gauche, sélectionnez le groupe de ressources et la région de l'instance source.

  4. Cliquez sur l'ID de l'instance source.

  5. Dans le coin supérieur droit, cliquez sur Migrate Databases.

Étape 2 : Configurer les bases de données source et de destination

Sur la page Create Migration Task, configurez les paramètres suivants :

Configure the source and destination databases

Section Paramètre Description
-- Nom de la tâche DTS génère automatiquement un nom. Spécifiez un nom descriptif pour faciliter l'identification. Les noms uniques ne sont pas requis.
Base de données source Type d'instance Sélectionnez ApsaraDB for MongoDB.
Région de l'instance Sélectionnez la région de l'instance source. Dans cet exemple, sélectionnez China (Qingdao).
ID de l'instance MongoDB Sélectionnez l'ID de l'instance source.
Nom de la base de données Saisissez le nom de la base de données d'authentification. Pour utiliser le compte root, saisissez admin.
Compte de base de données Saisissez le nom d'utilisateur de l'instance source. Pour connaître les autorisations requises, consultez la section Autorisations requises.
Mot de passe de la base de données Saisissez le mot de passe. Cliquez sur Test Connectivity pour vérifier. Un message Passed indique une connexion réussie. Si un message Failed s'affiche, cliquez sur Check pour résoudre les problèmes.
Base de données de destination Type d'instance Sélectionnez MongoDB Instance.
Région de l'instance Sélectionnez la région de l'instance de destination. Dans cet exemple, sélectionnez China (Hangzhou).
ID de l'instance MongoDB Sélectionnez l'ID de l'instance de destination.
Nom de la base de données Saisissez le nom de la base de données d'authentification. Pour utiliser le compte root, saisissez admin.
Compte de base de données Saisissez le nom d'utilisateur de l'instance de destination. Pour connaître les autorisations requises, consultez la section Autorisations requises.
Mot de passe de la base de données Saisissez le mot de passe. Cliquez sur Test Connectivity pour vérifier. Un message Passed indique une connexion réussie. Si un message Failed s'affiche, cliquez sur Check pour résoudre les problèmes.

Cliquez sur Set Whitelist and Next.

Avertissement

DTS ajoute automatiquement ou manuellement ses blocs CIDR à la liste d'autorisation de l'instance ou aux règles du groupe de sécurité ECS. Sécurisez vos identifiants, limitez les ports exposés, authentifiez les appels API et examinez régulièrement les entrées de la liste d'autorisation. Vous pouvez également vous connecter via Express Connect, VPN Gateway ou Smart Access Gateway (SAG).

Étape 3 : Sélectionner les types de migration et les objets

Select the migration types and the objects to be migrated

Paramètre Description
Sélectionner les types de migration Sélectionnez uniquement Full Data Migration, ou sélectionnez à la fois Full Data Migration et Incremental Data Migration pour maintenir la synchronisation de la destination pendant la migration.
Remarque

Les instances autonomes ne prennent pas en charge Incremental Data Migration. Si la migration incrémentielle n'est pas sélectionnée, n'écrivez pas de données dans la source pendant la migration complète des données afin de maintenir la cohérence des données.

Sélectionner les objets à migrer Sélectionnez les objets dans la section Available et cliquez sur l'icône de flèche vers la droite pour les déplacer vers la section Selected.
Remarque

DTS ne peut pas migrer les données des bases de données admin ou local. Les objets migrables incluent les bases de données, les collections et les fonctions. Pour renommer les objets dans la destination, utilisez la fonctionnalité de mappage des noms d'objets.

Spécifier s'il faut renommer les objets Renommez les objets dans la destination en utilisant le mappage des noms d'objets.
Spécifier la plage de temps de nouvelle tentative en cas d'échec de connexion à la base de données source ou de destination Par défaut, DTS tente de reconnecter les connexions échouées pendant jusqu'à 12 heures. Des frais s'appliquent pendant les nouvelles tentatives. Libérez l'instance DTS si la source ou la destination devient indisponible.

Étape 4 : Exécuter la pré-vérification et démarrer la migration

  1. Cliquez sur Precheck pour valider la configuration.

    • Si la pré-vérification échoue, cliquez sur View Details à côté de chaque élément ayant échoué, corrigez les problèmes et exécutez à nouveau la pré-vérification.

    • Les avertissements ne bloquent pas la pré-vérification. Corrigez-les ou ignorez-les, mais ignorer les avertissements peut affecter les résultats de la migration.

  2. Une fois la pré-vérification réussie, cliquez sur Next.

  3. Dans la boîte de dialogue Confirm Settings, sélectionnez la Instance Class et acceptez les Data Transmission Service (Pay-As-You-Go) Service Terms.

  4. Cliquez sur Buy and Start pour démarrer la tâche de migration.

Étape 5 : Surveiller la migration et effectuer le basculement

  • Full data migration : N'arrêtez pas manuellement la tâche. Attendez qu'elle se termine automatiquement.

  • Incremental data migration : La tâche ne s'arrête pas automatiquement. Effectuez le basculement comme suit :

    1. Attendez que la barre de progression affiche Incremental Data Migration et que le statut indique The migration task is not delayed.

    2. Arrêtez l'écriture des données dans l'instance source pendant quelques minutes.

    3. Attendez que le statut revienne à The migration task is not delayed.

    4. Arrêtez manuellement la tâche de migration.

Une fois la migration terminée, basculez vos charges de travail vers l'instance de destination.

Vérifier la migration

Après la migration, vérifiez les résultats :

  • Comparez le nombre de documents entre la source et la destination pour détecter toute perte de données.

  • Vérifiez que les index sont correctement créés dans la destination.

  • Testez la connectivité de l'application à l'instance de destination.

Étapes suivantes

Si l'instance source n'est plus nécessaire, libérez-la :

  • Instance au paiement à l'utilisation : Libérez l'instance directement.

  • Instance par abonnement : L'instance ne peut pas être libérée avant la fin du cycle de facturation.