Partager via

Résoudre les problèmes de connexion à Azure Cosmos DB for PostgreSQL

  • Article

S’APPLIQUE À : Azure Cosmos DB for PostgreSQL (avec l’extension de base de données Citus pour PostgreSQL)

Les problèmes de connexion peuvent avoir plusieurs causes, telles que :

  • Paramètres du pare-feu
  • Expiration du délai de connexion
  • Informations de connexion incorrectes
  • Limite de connexion atteinte pour le cluster
  • Problèmes liés à l’infrastructure du service
  • Maintenance des services
  • Le nœud coordinateur a basculé sur le nouveau matériel

En général, les problèmes de connexion à Azure Cosmos DB for PostgreSQL peuvent être classés ainsi :

  • Erreurs temporaires (de courte durée ou intermittentes)
  • Erreurs persistantes ou non temporaires (erreurs qui se produisent régulièrement)

Résoudre les erreurs temporaires

Les erreurs temporaires se produisent pour plusieurs raisons. Parmi les plus courantes : la maintenance du système, les erreurs liées au matériel ou aux logiciels et les mises à niveau vCore des nœuds coordinateurs.

L’activation de la haute disponibilité pour les nœuds de cluster peut atténuer automatiquement ces types de problèmes. Toutefois, votre application doit toujours être préparée à perdre brièvement sa connexion. D’autres événements peuvent également prendre plus de temps à s’atténuer, par exemple lorsqu’une transaction volumineuse entraîne une récupération de longue durée.

Étapes pour résoudre les problèmes de connectivité transitoire

  1. Consultez le tableau de bord du service Microsoft Azure pour obtenir la liste des interruptions connues qui se sont produites au moment où l’application a signalé des erreurs.
  2. Les applications qui se connectent à un service cloud tel que Azure Cosmos DB for PostgreSQL doivent s’attendre à des erreurs temporaires et réagir correctement. Par exemple, les applications doivent implémenter une logique de nouvelle tentative pour gérer ces erreurs au lieu de les exposer en tant qu’erreurs d’application aux utilisateurs.
  3. Lorsqu’un cluster approche des limites de ressources, les erreurs peuvent s’apparenter à des problèmes de connectivité temporaires. L’augmentation de la RAM du nœud, ou l’ajout de nœuds Worker et le rééquilibrage des données peuvent vous aider.
  4. Si les problèmes de connectivité persistent ou durent plus de 60 secondes, ou encore se produisent plusieurs fois par jour, effectuez une requête de support Azure en sélectionnant Obtenir de l’aide sur le site Support Azure.

Résoudre les erreurs persistantes

Si, à plusieurs reprises, l’application ne parvient pas à se connecter à Azure Cosmos DB for PostgreSQL, les causes les plus courantes sont un problème de configuration du pare-feu ou une erreur de l’utilisateur.

  • Configuration du pare-feu du nœud coordinateur : assurez-vous que le pare-feu du serveur est configuré pour autoriser les connexions côté client, y compris les serveurs proxy et les passerelles.
  • Configuration du pare-feu côté client : le pare-feu du client doit autoriser les connexions au serveur de base de données. Certains pare-feu nécessitent non seulement l’autorisation d’une application par son nom, mais aussi des adresses IP et des ports du serveur.
  • Erreur utilisateur : Vérifiez la chaîne de connexion. Vous avez peut-être mal saisi des paramètres comme le nom du serveur. Vous pouvez rechercher des chaînes de connexion pour différentes infrastructures de langage et psql dans le Portail Azure. Accédez à la page Chaînes de connexion de votre cluster. Gardez également à l’esprit que les clusters ne possèdent qu’une seule base de données et que son nom prédéfini est citus.

Étapes permettant résoudre les problèmes de connectivité persistants

  1. Configurez les règles de pare-feu pour autoriser l’adresse IP du client. Définissez une règle de pare-feu avec 0.0.0.0 pour adresse IP initiale et 255.255.255.255 pour adresse IP finale à des fins de test temporaire uniquement. Cette règle ouvre le serveur à toutes les adresses IP. Si la règle résout votre problème de connectivité, supprimez-la et créez une règle de pare-feu pour une adresse ou une plage d’adresses IP correctement bornée.
  2. Sur tous les pare-feu situés entre le client et l’Internet, assurez-vous que le port 5432 est ouvert pour les connexions sortantes (et le port 6432 si vous utilisez le regroupement des connexions).
  3. Vérifiez votre chaîne de connexion et d’autres paramètres de connexion.
  4. Vérifiez l’état du service dans le tableau de bord.

Étapes suivantes