Herstellen einer Verbindung mit einem Cluster in Azure Cosmos DB for PostgreSQL

GILT FÜR: Azure Cosmos DB for PostgreSQL (unterstützt von der Citus-Datenbankerweiterung auf PostgreSQL)

Wählen Sie einen der folgenden Datenbank-Clients aus, um zu erfahren, wie Sie ihn für die Verbindung mit einem Azure Cosmos DB for PostgreSQL-Cluster konfigurieren.

pgAdmin

pgAdmin ist eine beliebte Open-Source-Administrations- und Entwicklungsplattform für PostgreSQL mit vielen Features.

1. Laden Sie pgAdmin herunter, und installieren Sie es.

2. Öffnen Sie die Anwendung pgAdmin auf dem Clientcomputer. Wählen Sie im Dashboard Neuen Server hinzufügen aus.

   

3. Wählen Sie auf der Registerkarte „Allgemein“ einen Namen aus. Jeder Name funktioniert.

   

4. Geben Sie Verbindungsdetails auf der Registerkarte „Verbindung“ ein.

   

   Passen Sie die folgenden Felder an:

   • Hostname/Adresse: Rufen Sie diesen Wert auf der Seite Übersicht für Ihren Cluster im Azure-Portal ab. Er wird dort als Koordinatorname aufgeführt. Er hat das Format c-<clustername>.12345678901234.postgres.cosmos.azure.com.
   • Wartungsdatenbank: Verwenden Sie den Wert citus.
   • Benutzername: Verwenden Sie den Wert citus.
   • Passwort: das Verbindungspasswort oder das Microsoft Entra ID-Token. Weitere Informationen finden Sie unter Authentifizierungsoptionen.
   • Kennwort speichern: Aktivieren, falls gewünscht.

5. Legen Sie auf der Registerkarte „SSL“ den SSL-Modus auf Erforderlich fest.

   

6. Wählen Sie Speichern aus, um zu speichern und eine Verbindung mit der Datenbank herzustellen.

psql

Das Hilfsprogramm psql ist ein terminalbasiertes Front-End für PostgreSQL. Es ermöglicht Ihnen, Abfragen interaktiv einzugeben, sie in PostgreSQL auszugeben und die Abfrageergebnisse anzuzeigen.

1. Installieren Sie psql. Es ist in einer PostgreSQL-Installation enthalten oder separat in Paket-Managern für mehrere Betriebssysteme verfügbar.

2. Wählen Sie auf der Clusterseite im Azure-Portal das Menüelement Verbindungszeichenfolgen aus, und kopieren Sie dann die Verbindungszeichenfolge psql.

   

   Die Zeichenfolge psql hat die Form psql "host=c-<clustername>.<uniqueID>.postgres.cosmos.azure.com port=5432 dbname=citus user=citus password=<your_password> sslmode=require". Beachten Sie, dass der Hostname mit c- beginnt, z. B. c-demo.12345678901234.postgres.cosmos.azure.com. Dieses Präfix gibt den Koordinatorknoten des Clusters an. Der Standardwert für dbname und username lautet citus und kann nicht geändert werden.

3. Ersetzen Sie in der kopierten Verbindungszeichenfolge <your_password> durch Ihr Verbindungspasswort oder Microsoft Entra ID-Token. Weitere Informationen finden Sie unter Authentifizierungsoptionen.

4. Fügen Sie in einer lokalen Eingabeaufforderung des Terminals die psql-Verbindungszeichenfolge ein und drücken Sie dann die EINGABETASTE.

Nächste Schritte

• Beheben von Verbindungsproblemen.
• Überprüfen von TLS-Zertifikaten in Ihren Verbindungen.
• Nachdem Sie nun eine Verbindung mit der Datenbank herstellen können, erfahren Sie, wie Sie skalierbare Apps erstellen.