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

Von Bedeutung

Azure Cosmos DB für PostgreSQL wird für neue Projekte nicht mehr unterstützt. Verwenden Sie diesen Dienst nicht für neue Projekte. Verwenden Sie stattdessen einen der folgenden beiden Dienste:

• Verwenden Sie für hochskalige Szenarien eine verteilte Datenbanklösung mit Azure Cosmos DB für NoSQL, die ein 99,999%iges Verfügbarkeits-Service-Level-Agreement (SLA), eine sofortige Autoskalierung und ein automatisches regionenübergreifendes Failover bietet.

• Verwenden Sie die Elastic Clusters-Funktion von Azure Database for PostgreSQL für geshartete PostgreSQL-Datenbanken mithilfe der Open-Source-Erweiterung Citus.

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. Es wird die Form c-<clustername>.12345678901234.postgres.cosmos.azure.com haben.
   • 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.