Guide de résolution des problèmes : réplication inter-régions et de même région dans Azure DocumentDB

Ce guide est conçu pour vous aider à résoudre les problèmes courants liés à l’utilisation de la réplication de cluster avec Azure DocumentDB. Il offre des solutions pratiques pour les problèmes de connectivité et les défis d’optimisation afin d’améliorer votre expérience.

Problèmes courants et solutions

Mes données ne semblent pas être répliquées vers un cluster de réplica.

Assurez-vous qu'une réplica a été créée pour votre cluster. Un cluster réplica peut être créé lors de l’approvisionnement initial du cluster, ou ajouté ultérieurement. Vous pouvez vérifier l’existence d’un réplica sur la page « Vue d’ensemble » ou en créer une dans la page « Distribution globale » de votre cluster dans le portail Azure.

Je ne trouve pas de chaîne de connexion pour le cluster réplica.

Le cluster réplica est un réplica complet du cluster principal avec les écritures désactivées. Elle est représentée en tant que ressource de cluster distincte dans Azure et possède sa propre chaîne de connexion.

Pour localiser le cluster réplica :

• Ouvrez la page des propriétés du cluster principal dans le portail Azure.
• Accédez à la page « Distribution globale », puis cliquez sur le nom hypertexte du cluster réplica.
• Dans les propriétés du cluster réplica, accédez à la page « Chaînes de connexion » pour copier la chaîne de connexion.

Je ne parviens pas à me connecter au cluster de réplication.

Vérifiez que l’accès public ou privé est activé pour le cluster réplica. Lorsqu’un cluster de réplica est créé dans une autre région, ses paramètres réseau ne sont pas répliqués automatiquement à partir du cluster Azure DocumentDB principal.

Pour activer l’accès :

• Pour autoriser l’accès public, ajoutez des règles de pare-feu.
• Vous pouvez également créer des points de terminaison privés pour activer l’accès privé au cluster réplica.

Comment puis-je suivre l’utilisation de différentes ressources telles que la mémoire ou les IOPS sur mon cluster réplica ?

Étant donné que le cluster réplica est un réplica complet du cluster Azure DocumentDB principal, il possède ses propres métriques pour surveiller la consommation des ressources.

Pour afficher les métriques :

1. Ouvrez la page des propriétés du cluster réplica dans le portail Azure.
2. Accédez à la page Métriques pour consulter les détails de la consommation des ressources.

Consultez des instructions plus détaillées sur l’utilisation des métriques avec Azure DocumentDB sur cette page.

Comment faire pour ouvrir un cluster réplica dans une autre région pour les écritures ?

Vous pouvez promouvoir le cluster réplica en cluster en lecture-écriture à tout moment. Lorsque vous promouvez le cluster réplica dans la région B, l’ancien cluster principal de la région A est défini en mode lecture seule, ce qui en fait le cluster réplica pour le cluster principal nouvellement promu.

Pour promouvoir le cluster réplica :

1. Ouvrez la page des propriétés du cluster réplica dans le portail Azure.
2. Accédez à la page Distribution globale.
3. Sélectionnez Promouvoir et confirmez la promotion.

Pendant le processus de promotion, la chaîne de connexion en lecture-écriture globale est mise à jour de façon à pointer vers le cluster réplica récemment promu une fois qu’il est ouvert pour les opérations d’écriture.

Le cluster réplica n’est plus nécessaire. Comment faire pour désactiver la réplication et supprimer le cluster réplica ?

Vous pouvez supprimer un cluster réplica à tout moment sans impacter le cluster principal ou les données stockées et écrites dans celui-ci. Toutefois, si vous devez supprimer à la fois le réplica et le cluster principal, veillez à supprimer le cluster réplica en premier.

Pour supprimer un cluster réplique :

1. Ouvrez la page des propriétés du cluster réplica dans le portail Azure.
2. Dans la page Vue d’ensemble, sélectionnez Supprimer dans la barre d’outils.
3. Lisez attentivement le message d’avertissement et confirmez la suppression.

Étapes suivantes

• Si vous avez suivi toutes les étapes de résolution des problèmes et que vous ne pouvez toujours pas résoudre votre problème, vous pouvez ouvrir une demande de support afin d’obtenir une assistance supplémentaire.
• Si vous résolvez les problèmes courants liés à Azure DocumentDB, consultez ce guide de résolution des problèmes.