Připojení ke clusteru pomocí psql – Azure Cosmos DB for PostgreSQL

Důležité

Azure Cosmos DB for PostgreSQL se už pro nové projekty nepodporuje. Tuto službu nepoužívejte pro nové projekty. Místo toho použijte jednu z těchto dvou služeb:

• Azure Cosmos DB for NoSQL můžete použít pro distribuované databázové řešení navržené pro vysoce škálovatelné scénáře s 99,999% smlouvou o úrovni služeb (SLA), okamžitým automatickým škálováním a automatickým převzetím služeb při selhání napříč několika oblastmi.

• Použijte funkci Elastic Clusters služby Azure Database for PostgreSQL pro horizontálně dělené PostgreSQL pomocí opensourcového rozšíření Citus.

V tomto rychlém startu se dozvíte, jak pomocí připojovací řetězec psql v Azure Cloud Shellu připojit ke clusteru Azure Cosmos DB for PostgreSQL.

Požadavky

• Účet Azure s aktivním předplatným. Pokud ho nemáte, vytvořte si účet zdarma.
• Klastr Azure Cosmos DB pro PostgreSQL. Pokud chcete vytvořit cluster, přečtěte si téma Vytvoření clusteru na webu Azure Portal.

Připojit

Váš cluster má výchozí databázi s názvem citus. K připojení k databázi se používá připojovací řetězec a heslo správce.

1. Na webu Azure Portal na stránce clusteru vyberte položku nabídky Připojovací řetězce a zkopírujte připojovací řetězec psql.

   

   Řetězec psql je ve formátu psql "host=c-<cluster>.<uniqueID>.postgres.cosmos.azure.com port=5432 dbname=citus user=citus password={your_password} sslmode=require". Všimněte si, že název hostitele začíná c.například c-mycluster.12345678901234.postgres.cosmos.azure.com. Tato předpona označuje koordinační uzel clusteru. Výchozí dbname hodnota je citus a dá se změnit jenom v době zřizování clusteru. Může user to být jakákoli platná role Postgres ve vašem clusteru.

2. Otevřete Azure Cloud Shell výběrem ikony Cloud Shellu v horním řádku nabídek.

   

   Pokud se zobrazí výzva, zvolte předplatné Azure, do kterého chcete ukládat data Cloud Shellu.

3. Vložte připojovací řetězec psql do příkazového řádku.

4. V připojovací řetězec nahraďte {your_password} heslem clusteru nebo tokenem Microsoft Entra ID a stiskněte Enter.

   

   Když se psql úspěšně připojí k databázi, zobrazí se nová citus=> výzva (nebo vlastní název databáze):

   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. Spusťte testovací dotaz. Do příkazového řádku psql vložte následující příkaz a stiskněte Enter.

   SHOW server_version;
   

   Měli byste vidět výsledek odpovídající verzi PostgreSQL, kterou jste vybrali při vytváření clusteru. Například:

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

Další kroky

Teď, když jste se připojili ke clusteru, je dalším krokem vytvoření tabulek a jejich horizontální dělení pro horizontální škálování.

Vytváření a distribuce tabulek >