Tous les produits
Search
Centre de documentation

ApsaraDB for MongoDB:Changer les rôles des nœuds

Dernière mise à jour :Aug 08, 2026

Basculez le nœud primaire d'une instance ApsaraDB for MongoDB afin de la colocaliser avec vos serveurs d'application et de réduire la latence d'écriture interzones.

Emplacement des zones et latence d'écriture

Dans un replica set ou un sharded cluster, ApsaraDB for MongoDB désigne un nœud comme primaire et les autres comme secondaires. Toutes les opérations d'écriture sont dirigées vers le nœud primaire. Si vos serveurs d'application Elastic Compute Service (ECS) se trouvent dans une zone différente de celle du nœud primaire, chaque écriture traverse les zones, ce qui augmente la latence et dégrade le débit.

Environment for role switchover

Par exemple, si vos instances ECS sont situées dans la Zone 2 et que le nœud primaire se trouve dans la Zone 1, les écritures transitent entre les zones à chaque requête. Le basculement du rôle primaire vers la Zone 2 permet de maintenir le trafic au sein de la même zone.

Un basculement modifie uniquement les rôles des nœuds ; les zones et les ID de rôle restent identiques. Après l'opération, le nœud qui était secondaire reste physiquement dans la Zone 2 ; il devient simplement primaire.

Prérequis

Avant de commencer, assurez-vous que :

  • Votre instance ApsaraDB for MongoDB est de type replica set ou sharded cluster.

Planification et limitations

  • Déconnexion pendant le basculement : Chaque basculement peut entraîner une déconnexion de l'instance pendant jusqu'à 30 secondes. Planifiez l'opération pendant les heures creuses et vérifiez que votre application peut se reconnecter automatiquement à l'instance.

  • Sharded clusters : Pour les instances de type sharded cluster, vous pouvez gérer la distribution des zones uniquement pour les nœuds shard et Configserver.

  • Roles only, not zones: Après un basculement, les zones des nœuds et les ID de rôle restent inchangés. Seule la désignation primaire/secondaire est modifiée.

Changer les rôles dans la console

  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 selon le type de votre instance.

  3. Dans l'angle supérieur gauche de la page, sélectionnez le groupe de ressources et la région où se trouve l'instance.

  4. Cliquez sur l'ID de l'instance, ou cliquez sur More icon dans la colonne Actions puis sélectionnez Manage.

  5. Dans le volet de navigation de gauche de la page des détails de l'instance, cliquez sur Service Availability.

  6. Dans la section Zone Distribution, cliquez sur Switch Role dans l'angle supérieur gauche.

    Pour les instances de type sharded cluster, accédez à la section Zone Distribution for Shards ou Zone Distribution for Configservers puis cliquez sur Switch Role .
  7. Dans le panneau Switch Role, configurez les paramètres suivants.

    Parameter Description
    Role (avant) Le rôle du nœud avant le basculement.
    Role (après) Le rôle du nœud après le basculement.
    Effective At Moment d'exécution du basculement. Sélectionnez Effective Immediately pour l'exécuter immédiatement, ou Effective Within Maintenance Window pour le planifier. Si vous choisissez Effective Within Maintenance Window, sélectionnez la fenêtre actuelle ou personnalisez-en une dans la liste déroulante Change Maintenance Window.
  8. Cliquez sur OK.

Vérifier le basculement

Une fois le basculement terminé, confirmez que les rôles des nœuds ont changé comme prévu :

  1. Sur la page Service Availability, consultez la section Zone Distribution.

  2. Vérifiez que le nœud situé dans votre zone cible apparaît désormais comme primaire, et que l'ancien nœud primaire apparaît comme secondaire.