Delen via

Verbinding maken met een cluster met psql - Azure Cosmos DB for PostgreSQL

  • Artikel

VAN TOEPASSING OP: Azure Cosmos DB for PostgreSQL (mogelijk gemaakt door de Citus-database-extensie naar PostgreSQL)

In deze quickstart ziet u hoe u de psql-verbindingsreeks in Azure Cloud Shell gebruikt om verbinding te maken met een Azure Cosmos DB for PostgreSQL-cluster.

Vereisten

Verbinden

Uw cluster heeft een standaarddatabase met de naam citus. Als u verbinding wilt maken met de database, gebruikt u een verbindingsreeks en het beheerderswachtwoord.

  1. Selecteer in Azure Portal op de clusterpagina de menuopdracht Verbindingsreeksen en kopieer vervolgens de psql-verbindingsreeks.

    Schermopname van het kopiëren van de psql-verbindingsreeks.

    De psql-tekenreeks is van het formulier psql "host=c-<cluster>.<uniqueID>.postgres.cosmos.azure.com port=5432 dbname=citus user=citus password={your_password} sslmode=require". U ziet dat de hostnaam begint met bijvoorbeeld een c..c-mycluster.12345678901234.postgres.cosmos.azure.com Dit voorvoegsel geeft het coördinatorknooppunt van het cluster aan. De standaardwaarde dbname is citus en kan alleen worden gewijzigd tijdens het inrichten van clusters. Dit user kan elke geldige Postgres-rol in uw cluster zijn.

  2. Open Azure Cloud Shell door het Cloud Shell-pictogram in de bovenste menubalk te selecteren.

    Schermopname van het Cloud Shell-pictogram.

    Als u hierom wordt gevraagd, kiest u een Azure-abonnement waarin Cloud Shell-gegevens moeten worden opgeslagen.

  3. Plak uw psql-verbindingsreeks in de shell.

  4. Vervang in het verbindingsreeks door {your_password} uw clusterwachtwoord of Microsoft Entra ID-token en druk op Enter.

    Schermopname van het uitvoeren van psql in Cloud Shell.

    Wanneer psql verbinding maakt met de database, ziet u een nieuwe citus=> prompt (of de aangepaste naam van uw database):

    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. Voer een testquery uit. Plak de volgende opdracht in de psql-prompt en druk op Enter.

    SHOW server_version;

    Er wordt een resultaat weergegeven dat overeenkomt met de PostgreSQL-versie die u hebt geselecteerd tijdens het maken van het cluster. Bijvoorbeeld:

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

Volgende stappen

Nu u verbinding hebt gemaakt met het cluster, is de volgende stap het maken van tabellen en het sharden van tabellen voor horizontaal schalen.

Tabellen maken en distribueren >