連線至 Azure Cosmos DB for PostgreSQL 叢集

適用於： Azure Cosmos DB for PostgreSQL (由 Citus 資料庫延伸模組支援 PostgreSQL)

選擇下列其中一個資料庫用戶端，以查看如何設定該用戶端以連線至 Azure Cosmos DB for PostgreSQL 叢集。

pgAdmin

pgAdmin 是適用於 PostgreSQL 的熱門且功能豐富的開放原始碼管理與開發平台。

1. 下載並安裝 pgAdmin。

2. 在您的用戶端電腦上開啟 pgAdmin 應用程式。 從儀表板選取 [新增伺服器]。

   

3. 在 [一般] 索引標籤中選擇 [名稱]。任何名稱都會正常運作。

   

4. 在 [連線] 索引標籤中輸入連線詳細資料。

   

   自訂下列欄位：

   • 主機名稱/位址：從 Azure 入口網站中叢集的 [概觀] 頁面取得此值。 其列在該處作為 [協調器名稱]。 其格式會是 c-<clustername>.12345678901234.postgres.cosmos.azure.com。
   • 維護資料庫：使用 citus 值。
   • 使用者名稱：使用 citus 值。
   • 密碼：連線密碼。
   • 儲存密碼：視需要啟用。

5. 在 SSL 索引標籤中，將 [SSL 模式] 設定為 [需要]。

   

6. 選取 [儲存] 以儲存並連線到資料庫。

psql

psql 公用程式是 PostgreSQL 的終端機型前端。 它可讓您以互動方式鍵入查詢、將其發給 PostgreSQL，以及查看查詢結果。

1. 安裝 psql。 其隨附於 PostgreSQL 安裝，或在數個作業系統的套件管理員中個別提供。

2. 在 Azure 入口網站的叢集頁面上，選取 [連接字串] 功能表項目，然後複製 psql 連接字串。

   

   psql 字串的格式為 psql "host=c-<clustername>.<uniqueID>.postgres.cosmos.azure.com port=5432 dbname=citus user=citus password=<your_password> sslmode=require"。 請注意，主機名稱開頭為 c-，例如 c-demo.12345678901234.postgres.cosmos.azure.com。 此前置詞表示該叢集的協調器節點。 預設 dbname 和 username 是 citus 且無法變更。

3. 在您複製的連接字串中，將 <your_password> 取代為您的管理密碼。

4. 在本機終端機提示中，貼上 psql 連接字串，然後按 Enter。

下一步

• 針對連線問題進行疑難排解。
• 在您的連線中驗證 TLS 憑證。
• 既然您可以連線到資料庫，請了解如何建置可調整的應用程式。