Partager via

Se connecter à un cluster avec psql - Azure Cosmos DB for PostgreSQL

  • Article

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

Ce guide de démarrage rapide vous montre comment utiliser la chaîne de connexion psql dans Azure Cloud Shell pour vous connecter à un cluster Azure Cosmos DB for PostgreSQL.

Prérequis

Se connecter

Votre cluster a une base de données par défaut nommée citus. Pour vous connecter à la base de données, vous utilisez une chaîne de connexion et le mot de passe d'administration.

  1. 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.

    Capture d’écran montrant la chaîne de connexion psql.

    La chaîne psql a la forme psql "host=c-<cluster>.<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-mycluster.12345678901234.postgres.cosmos.azure.com. Ce préfixe indique le nœud coordinateur du cluster. La valeur par défaut dbname est citus et peut uniquement être modifiée au moment de l’approvisionnement du cluster. user peut être n’importe quel rôle Postgres valide sur votre cluster.

  2. Ouvrez une session Azure Cloud Shell en sélectionnant l’icône Cloud Shell dans la barre de menu supérieure.

    Capture d’écran qui montre l’icône Cloud Shell.

    Si vous y êtes invité, choisissez un abonnement Azure dans lequel stocker les données Cloud Shell.

  3. Collez votre chaîne de connexion psql dans l’interpréteur de commandes.

  4. Dans la chaîne de connexion, remplacez {your_password} par le mot de passe de votre cluster ou le jeton Microsoft Entra ID, puis appuyez sur Entrée.

    Capture d’écran montrant l’exécution de psql dans le Cloud Shell.

    Lorsque PSQL se connecte correctement à la base de données, une nouvelle invite citus=> (ou le nom personnalisé de votre base de données) s’affiche :

    psql (14.2, server 14.5)
SSL connection (protocol: TLSv1.2, cipher: ECDHE-RSA-AES256-GCM-SHA384, bits: 256, compression: off)
Type "help" for help.

citus=>

  5. Exécutez une requête test. Collez la commande suivante dans l’invite psql, puis appuyez sur Entrée.

    SHOW server_version;

    Vous devez voir un résultat correspondant à la version PostgreSQL que vous avez sélectionnée lors de la création du cluster. Exemple :

     server_version
----------------
 14.5
(1 row)

Étapes suivantes

Maintenant que vous êtes connecté au cluster, l’étape suivante consiste à créer des tables et à les partitionner pour la mise à l’échelle horizontale.

Créer et distribuer des tables >