Se connecter à un cluster dans Azure Cosmos DB for PostgreSQL

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

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 : mot de passe de la connexion.
   • 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. 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 administratif.

4. Dans une invite de 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.