Nawiązywanie połączenia z klastrem w usłudze Azure Cosmos DB for PostgreSQL

Ważne

Usługa Azure Cosmos DB for PostgreSQL nie jest już obsługiwana w przypadku nowych projektów. Nie używaj tej usługi dla nowych projektów. Zamiast tego użyj jednej z tych dwóch usług:

• Użyj usługi Azure Cosmos DB for NoSQL dla rozproszonego rozwiązania bazy danych przeznaczonego dla scenariuszy o dużej skali z umową dotyczącą poziomu usług dostępności 99,999% (SLA), natychmiastowym skalowaniem automatycznym i automatycznym przejściem w tryb failover w wielu regionach.

• Użyj funkcji Elastic Clusters usługi Azure Database for PostgreSQL na potrzeby fragmentowanej bazy danych PostgreSQL przy użyciu rozszerzenia Citus typu open source.

Wybierz jednego z następujących klientów bazy danych, aby zobaczyć, jak skonfigurować go w celu nawiązania połączenia z klastrem usługi Azure Cosmos DB for PostgreSQL.

pgAdmin

pgAdmin to popularna i bogata w funkcje platforma do administrowania i programowania typu open source dla bazy danych PostgreSQL.

1. Pobierz i zainstaluj narzędzie pgAdmin.

2. Otwórz aplikację pgAdmin na swoim komputerze klienckim. Na pulpicie nawigacyjnym wybierz pozycję Dodaj nowy serwer.

   

3. Wybierz nazwę na karcie Ogólne. Każda nazwa będzie działać.

   

4. Wprowadź szczegóły połączenia na karcie Połączenie.

   

   Dostosuj następujące pola:

   • Nazwa/adres hosta: uzyskaj tę wartość na stronie Przegląd klastra w witrynie Azure Portal. Jest tam wymieniona jako nazwa koordynatora. Będzie ona mieć postać c-<clustername>.12345678901234.postgres.cosmos.azure.com.
   • Baza danych konserwacji: użyj wartości citus.
   • Nazwa użytkownika: użyj wartości citus.
   • Hasło: hasło połączenia lub token Microsoft Entra ID. Aby uzyskać więcej informacji, zobacz opcje uwierzytelniania.
   • Zapisz hasło: włącz w razie potrzeby.

5. Na karcie SSL ustaw tryb SSL na Wymagaj.

   

6. Wybierz pozycję Zapisz , aby zapisać bazę danych i nawiązać z nią połączenie.

psql

Narzędzie psql to interfejs użytkownika działające w terminalu do bazy danych PostgreSQL. Umożliwia ona interaktywne wpisywanie zapytań, wydawanie ich w usłudze PostgreSQL i wyświetlanie wyników zapytania.

1. Zainstaluj narzędzie psql. Jest on dołączony do instalacji bazy danych PostgreSQL lub dostępny oddzielnie w menedżerach pakietów dla kilku systemów operacyjnych.

2. W portalu Azure, na stronie klastra, wybierz element menu Connection strings, a następnie skopiuj psql parametry połączenia.

   

   Ciąg psql ma postać psql "host=c-<clustername>.<uniqueID>.postgres.cosmos.azure.com port=5432 dbname=citus user=citus password=<your_password> sslmode=require". Zwróć uwagę, że nazwa hosta zaczyna się od c-, na przykład c-demo.12345678901234.postgres.cosmos.azure.com. Ten prefiks wskazuje węzeł koordynacji klastra. Domyślne wartości dbname i username to citus i nie można ich zmieniać.

3. W skopiowanym ciągu połączenia zastąp <your_password> hasłem połączenia lub tokenem Microsoft Entra ID. Aby uzyskać więcej informacji, zobacz opcje uwierzytelniania.

4. W lokalnym wierszu polecenia terminalu wklej parametry połączenia psql, a następnie naciśnij Enter.

Następne kroki

• Rozwiąż problemy z połączeniem.
• Sprawdź certyfikaty TLS w połączeniach.
• Teraz, gdy możesz nawiązać połączenie z bazą danych, dowiedz się, jak tworzyć skalowalne aplikacje.