Se connecter à un cluster dans Azure Cosmos DB for PostgreSQL

Important

Azure Cosmos DB pour PostgreSQL n’est plus pris en charge pour les nouveaux projets. N’utilisez pas ce service pour les nouveaux projets. Utilisez plutôt l’un des deux services suivants :

• Utilisez Azure Cosmos DB pour NoSQL pour une solution de base de données distribuée conçue pour des scénarios à grande échelle avec un contrat de niveau de service de disponibilité (SLA) de 99,999%, une mise à l’échelle automatique instantanée et un basculement automatique entre plusieurs régions.

• Utilisez la fonctionnalité Elastic Clusters d'Azure Database pour PostgreSQL pour un PostgreSQL partagé utilisant l'extension open source Citus.

Choisissez l’un des clients de base de données suivants pour voir comment le configurer pour se connecter à un cluster Azure Cosmos DB for PostgreSQL.

pgAdmin

pgAdmin est une plateforme d’administration et de développement open source populaire et riche en fonctionnalités pour PostgreSQL.

1. Téléchargez et installez pgAdmin.

2. Ouvrez l’application pgAdmin sur votre ordinateur client. Dans le tableau de bord, sélectionnez Ajouter un nouveau serveur.

   

3. Choisissez un Nom sous l’onglet Général. Tout nom fonctionne.

   

4. Entrez les détails de connexion sous l’onglet Connexion.

   

   Personnalisez les champs suivants :

   • Nom d’hôte/adresse : obtenez cette valeur à partir de la page Présentation de votre clusters dans le portail Azure. Elle y est listée en tant que nom de coordinateur. Elle se présente sous la forme suivante c-<clustername>.12345678901234.postgres.cosmos.azure.com.
   • Base de données de maintenance : utilisez la valeur citus.
   • Nom d’utilisateur : utilisez la valeur citus.
   • Mot de passe : Le mot de passe de connexion ou le jeton Microsoft Entra ID. Pour plus d’informations, consultez Options d’authentification.
   • Enregistrer le mot de passe : activez cette option si vous le souhaitez.

5. Sous l’onglet SSL, définissez le mode SSL sur Exiger.

   

6. Sélectionnez Enregistrer pour enregistrer et vous connecter à la base de données.

psql

L’utilitaire psql est un front-end basé sur un terminal vers PostgreSQL. Il permet de taper des requêtes de manière interactive, de les émettre vers PostgreSQL et de consulter les résultats de la requête.

1. Installez psql. Il est inclus avec une installation PostgreSQL ou disponible séparément dans les gestionnaires de packages pour plusieurs systèmes d’exploitation.

2. Dans le portail Azure, dans la page de votre cluster, sélectionnez l’élément de menu Chaînes de connexion, puis copiez la chaîne de connexion psql.

   

   La chaîne psql a la forme psql "host=c-<clustername>.<uniqueID>.postgres.cosmos.azure.com port=5432 dbname=citus user=citus password=<your_password> sslmode=require". Notez que le nom d’hôte commence par un c-, par exemple c-demo.12345678901234.postgres.cosmos.azure.com. Ce préfixe indique le nœud coordinateur du cluster. Les dbname et username par défaut sont citus et ne peuvent pas être changés.

3. Dans la chaîne de connexion que vous avez copiée, remplacez <your_password> par votre mot de passe de connexion ou votre jeton Microsoft Entra ID. Pour plus d’informations, consultez Options d’authentification.

4. Dans le terminal local, collez la chaîne de connexion psql, puis appuyez sur Entrée.

Étapes suivantes

• Résolvez les problèmes de connexion.
• Vérifiez les certificats TLS dans vos connexions.
• Maintenant que vous pouvez vous connecter à la base de données, découvrez comment créer des applications scalables.