Nawiązywanie połączenia z klastrem za pomocą narzędzia psql — Azure Cosmos DB for PostgreSQL

DOTYCZY: Usługa Azure Cosmos DB for PostgreSQL (obsługiwana przez rozszerzenie bazy danych Citus do bazy danych PostgreSQL)

W tym przewodniku Szybki start pokazano, jak używać parametry połączenia psql w usłudze Azure Cloud Shell w celu nawiązania połączenia z klastrem usługi Azure Cosmos DB for PostgreSQL.

Wymagania wstępne

• Konto platformy Azure z aktywną subskrypcją. Jeśli go nie masz, utwórz bezpłatne konto.
• Klaster usługi Azure Cosmos DB for 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 witrynie Azure Portal na stronie klastra wybierz element menu Parametry połączenia, a następnie skopiuj parametry 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. Może to być dowolna prawidłowa user rola 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 parametry połączenia zastąp {your_password} ciąg hasłem klastra lub tokenem Microsoft Entra ID, a następnie naciśnij Enter.

   

   Po pomyślnym nawiązaniu połączenia z bazą danych zostanie wyświetlony nowy citus=> monit (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 >