Nawiązywanie połączenia z klastrem za pomocą narzędzia psql — 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.

W tym przewodniku "Szybki start" pokazano, jak używać ciągu połączeniowego psql w usłudze Azure Cloud Shell do nawiązania połączenia z klastrem Azure Cosmos DB dla PostgreSQL.

Wymagania wstępne

• Konto platformy Azure z aktywną subskrypcją. Jeśli go nie masz, utwórz bezpłatne konto.
• Klaster Azure Cosmos DB dla PostgreSQL. Aby utworzyć klaster, zobacz Tworzenie klastra w witrynie Azure Portal.

Połącz

Klaster ma domyślną bazę danych o nazwie citus. Aby nawiązać połączenie z bazą danych, należy użyć parametrów połączenia i hasła administratora.

1. W portalu Azure, na stronie klastra, wybierz element menu Ciągi połączeń, a następnie skopiuj ciąg połączenia psql.

   

   Ciąg psql ma postać psql "host=c-<cluster>.<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-mycluster.12345678901234.postgres.cosmos.azure.com. Ten prefiks wskazuje węzeł koordynacji klastra. Wartość domyślna dbname to citus i może zostać zmieniona tylko w czasie aprowizacji klastra. user Może być dowolną prawidłową rolą Postgres w klastrze.

2. Otwórz usługę Azure Cloud Shell, wybierając ikonę usługi Cloud Shell na górnym pasku menu.

   

   Jeśli zostanie wyświetlony monit, wybierz subskrypcję platformy Azure, w której będą przechowywane dane usługi Cloud Shell.

3. Wklej parametry połączenia psql w powłoce.

4. W ciągu połączenia zastąp {your_password} hasłem klastra lub tokenem Microsoft Entra ID, a następnie naciśnij Enter.

   

   Po pomyślnym nawiązaniu połączenia z bazą danych pojawi się nowy monit citus=> (lub niestandardowa nazwa bazy danych):

   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. Uruchom zapytanie testowe. Wklej następujące polecenie w wierszu polecenia psql, a następnie naciśnij Enter.

   SHOW server_version;
   

   Wynik powinien być zgodny z wersją bazy danych PostgreSQL wybraną podczas tworzenia klastra. Przykład:

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

Następne kroki

Po nawiązaniu połączenia z klastrem następnym krokiem jest utworzenie tabel i podzielenie ich na fragmenty na potrzeby skalowania w poziomie.

Tworzenie i dystrybuowanie tabel >