連線至 Azure Cosmos DB for PostgreSQL 叢集

這很重要

新專案不再支援適用於 PostgreSQL 的 Azure Cosmos DB。 請勿將此服務用於新專案。 請改用下列兩項服務之一：

• 使用 Azure Cosmos DB for NoSQL 作為專為高規模應用場景設計的分散式資料庫解決方案，其特色包括99.999% 的可用性服務等級協定（SLA）、即時自動調整，以及跨多個區域的自動容錯移轉。

• 針對使用開放原始碼超大規模 (Citus) 延伸模組的分區化 PostgreSQL 使用適用於 PostgreSQL 的 Azure 資料庫的彈性叢集功能。

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

pgAdmin

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

1. 下載並安裝 pgAdmin。

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

   

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

   

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

   

   自訂下列欄位：

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

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> 取代為您的連線密碼或 Microsoft Entra ID 權杖。 如需詳細資訊，請參閱驗證選項。

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

下一步

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