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

pgAdmin 是一个流行且功能丰富的 PostgreSQL 开源管理和开发平台。

1. 下载并安装 pgAdmin。

2. 在客户端计算机上打开 pgAdmin 应用程序。 在仪表板中，选择“添加新服务器”。

   

3. 在“常规”选项卡中选择“名称”。任何名称都将正常工作。

   

4. 在“连接”选项卡中输入连接详细信息。

   

   自定义以下字段：

   • 主机名/地址：从 Azure 门户中群集的“概述”页面获取此值。 它在其中列为协调器名称。 它的形式为 c-<clustername>.12345678901234.postgres.cosmos.chinacloudapi.cn。
   • 维护数据库：使用值 citus。
   • 用户名：使用值 citus。
   • 密码：连接密码或 Microsoft Entra ID 令牌。 有关详细信息，请参阅身份验证选项。
   • 保存密码：根据需要启用。

5. 在“SSL”选项卡中，将“SSL 模式”设置为“需要”。

   

6. 选择“保存”以保存并连接到数据库。

psql 实用程序是 PostgreSQL 的基于终端的前端。 它使你能够以交互方式键入查询，将其发布到 PostgreSQL，并查看查询结果。

1. 安装 psql。 psql 包含在 PostgreSQL 安装中，或者在多个操作系统的包管理器中单独提供。

2. 在 Azure 门户的群集页上，选择“连接字符串”菜单项，然后复制 psql 连接字符串。

   

   psql 字符串的格式为 psql "host=c-<clustername>.<uniqueID>.postgres.cosmos.chinacloudapi.cn port=5432 dbname=citus user=citus password=<your_password> sslmode=require"。 请注意，主机名以 c- 开头，例如 c-demo.12345678901234.postgres.cosmos.azure.cn。 此前缀指示群集的协调器节点。 默认的 dbname 和 username 为 citus，无法更改。

3. 在复制的连接字符串中，将 <your_password> 替换为连接密码或 Microsoft Entra ID 令牌。 有关详细信息，请参阅身份验证选项。

4. 在本地终端提示符中，粘贴 psql 连接字符串，然后按 Enter。