Ansluta till ett kluster med psql – Azure Cosmos DB för PostgreSQL

GÄLLER FÖR: Azure Cosmos DB for PostgreSQL (drivs av Citus-databastillägget till PostgreSQL)

Den här snabbstarten visar hur du använder psql-anslutningssträng i Azure Cloud Shell för att ansluta till ett Azure Cosmos DB for PostgreSQL-kluster.

Förutsättningar

• Ett Azure-konto med en aktiv prenumeration. Om du inte har något skapar du ett konto kostnadsfritt.
• Ett Azure Cosmos DB för PostgreSQL-kluster. Information om hur du skapar ett kluster finns i Skapa ett kluster i Azure Portal.

Anslut

Klustret har en standarddatabas med namnet citus. Om du vill ansluta till databasen använder du en anslutningssträng och administratörslösenordet.

1. I Azure-portalen går du till klustersidan, väljer menyalternativet Anslutningssträngar och sedan kopierar du psql-anslutningssträngen.

   

   Psql-strängen är av formatet psql "host=c-<cluster>.<uniqueID>.postgres.cosmos.azure.com port=5432 dbname=citus user=citus password={your_password} sslmode=require". Observera att värdnamnet börjar med en c., till exempel c-mycluster.12345678901234.postgres.cosmos.azure.com. Det här prefixet anger koordinatornoden i klustret. Standardvärdet dbname är citus och kan bara ändras vid klusteretablering. user Kan vara valfri giltig Postgres-roll i klustret.

2. Öppna Azure Cloud Shell genom att välja Cloud Shell-ikonen på den översta menyraden.

   

   Om du uppmanas till det väljer du en Azure-prenumeration där Cloud Shell-data ska lagras.

3. Klistra in psql-anslutningssträng i gränssnittet.

4. I anslutningssträngen, ersätt {your_password} med ditt klusterlösenord eller Microsoft Entra ID-token, och tryck sedan på Enter.

   

   När psql ansluter framgångsrikt till databasen visas en ny citus=>-prompt (eller det anpassade namnet på databasen):

   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. Kör en testfråga. Klistra in följande kommando i psql-prompten och tryck sedan på Retur.

   SHOW server_version;
   

   Du bör se ett resultat som matchar den PostgreSQL-version som du valde när klustret skapades. Till exempel:

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

Nästa steg

Nu när du har anslutit till klustret är nästa steg att skapa tabeller och fragmentera dem för horisontell skalning.

Skapa och distribuera tabeller >