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-niska veze 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-portalen.

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

I Azure-portalen går du till klustersidan och väljer menyalternativet Anslutningssträngar och kopierar sedan psql-niska veze.

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.
Ö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.
Klistra in psql-niska veze i gränssnittet.
I niska veze ersätter du {your_password} med ditt klusterlösenord och trycker sedan på Retur.

När psql ansluter till databasen visas en ny citus=> fråga (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=>
```
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)
```

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