除了通过PolarDB管理控制台登录数据库之外，您还可以通过pgAdmin 4客户端连接PolarDB集群。本章将介绍如何通过pgAdmin 4客户端连接PolarDB集群。

更多连接方式

除了通过pgAdmin 4客户端连接PolarDB集群外，您还可以在下载客户端和驱动页，下载安装客户端使用命令行工具连接PolarDB集群。

  • 通过JDBC连接PolarDB请参见文档JDBC。
  • 通过.NET连接PolarDB请参见文档.NET。
  • 通过ODBC连接PolarDB请参见文档ODBC。
  • 通过OCI连接PolarDB请参见文档OCI。

前提条件

  • 已创建数据库集群的高权限账号或普通账号。具体操作请参见创建数据库账号。
  • 已经将需要访问PolarDB集群的主机IP地址添加到白名单，如何添加白名单请参见设置集群白名单。
  • 已在可以连接PolarDB数据库的客户端（例如ECS）上安装pgAdmin 4。下载地址：pgAdmin 。

操作步骤

  1. 启动pgAdmin 4客户端。
  2. 右击Servers，选择创建 > 服务器 ，如下图所示。
    创建服务器
  3. 在创建-服务器页面的通常标签页面中，自定义服务器名称。
    pgadmin4-常规
  4. 选择Connection标签页，输入要连接的集群信息，参数说明如下。
    pgadmin-连接
    表 1. 参数说明
    参数 说明
    主机名称/地址

    输入PolarDB集群的连接地址。查看PolarDB集群的地址及端口信息的步骤如下：

    1. 登录PolarDB控制台。
    2. 在控制台左上角，选择集群所在地域。
    3. 单击目标集群ID。
    4. 在链接地址区域查看PolarDB地址。
    端口 需输入PolarDB O引擎集群端口，默认为1521。
    维护数据库 输入维护数据库，默认为postgres。
    用户名 PolarDB集群的账号，创建账号请参见创建数据库账号。
    密码 PolarDB集群账号所对应的密码。
  5. 单击保存。
  6. 若连接信息无误，单击目标数据库后出现类似如下界面，则表示连接成功。
    连接成功
  7. 右键单击目标数据库，选择查询工具...，打开如下页面后，即可对数据库进行增删改查等操作。
    查询窗口

下一步

Oracle兼容性操作指南

解决连接失败的问题

  • IP白名单设置有误。
    • 由于白名单设置中只有默认地址127.0.0.1。127.0.0.1表示禁止任何IP地址访问PolarDB集群。因此需在白名单中添加对端的IP地址，具体操作请参见设置集群白名单。
    • 白名单设置成了0.0.0.0，正确格式为0.0.0.0/0。
      注意 0.0.0.0/0表示允许任何设备访问PolarDB集群，请谨慎使用。
    • 您在白名单中添加的设备公网IP地址可能并非设备真正的出口IP地址。例如，公网IP地址不固定，可能会变动。或者IP地址查询工具、网站查询的公网IP地址不准确。
  • 私网、公网地址使用错误。

    使用私网地址从公网进行连接，或者使用公网地址从私网进行连接，都会导致连接失败。

    请确认您使用的地址类型。如果您需要从私网连接PolarDB集群，请使用PolarDB集群的私网地址；如果您需要从公网连接PolarDB集群，请使用PolarDB集群的公网地址。

  • DNS服务器无法解析地址。
    • PolarDB集群的连接地址输入错误，有如下几种常见情况：
      • PolarDB连接地址输入错误，您可以在控制台查看正确连接地址。如何查看连接地址，请参见查看连接地址和端口。
      • 使用的外网地址，但是外网地址已被手动释放。
      • 应用程序允许输入的连接地址长度有限，连接地址被应用程序截断。
    • 如果确认PolarDB集群的连接地址没有问题，可以将DNS服务器地址修改为阿里云的DNS服务器地址。
      网络环境 阿里云DNS服务器地址
      私网（经典网络） 10.143.22.116

      10.143.22.118
      私网（VPC网络） 100.100.2.136

      100.100.2.138
      公网 223.5.5.5

      223.6.6.6