连接到 Azure Cosmos DB for PostgreSQL 中的群集

重要

Azure Cosmos DB for PostgreSQL 处于停用路径，不再建议用于新项目。 请改用以下两个服务之一：

• 对于 PostgreSQL 工作负载：使用 Azure Database For PostgreSQL 的弹性群集功能 ，以使用开源 Citus 扩展中包含的横向扩展和分布式 PostgreSQL 功能。

• 对于 NoSQL 工作负荷，使用 Azure Cosmos DB for NoSQL 作为 分布式数据库解决方案，该解决方案包括 99.999% 可用性服务级别协议 （SLA）、即时自动缩放和跨多个区域的自动故障转移。

选择以下数据库客户端之一，了解如何将其配置为连接到 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。 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 证书。
• 你已经能够连接到数据库，请了解如何生成可扩展应用。