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-databaseextensie voor PostgreSQL)

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

Vereisten

Verbinding maken

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 de Azure Portal op de clusterpagina het menu-item Verbindingsreeksen en kopieer vervolgens de psql-connection string.

    Schermopname van het kopiëren van de psql-connection string.

    De psql-tekenreeks heeft de vorm 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 een c., bijvoorbeeld 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 het cluster. De user kan elke geldige Postgres-rol in uw cluster zijn.

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

    Schermopname van het pictogram Cloud Shell.

    Kies desgevraagd een Azure-abonnement waarin u Cloud Shell gegevens wilt opslaan.

  3. Plak uw psql-connection string in de shell.

  4. Vervang in de connection string door {your_password} uw clusterwachtwoord en druk op Enter.

    Schermopname van het uitvoeren van psql in de 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;

    U ziet een resultaat 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, bestaat de volgende stap uit het maken van tabellen en shards voor horizontaal schalen.

Tabellen maken en distribueren >