本文介绍如何通过数据管理DMS和客户端连接PolarDB数据库集群。

前提条件

  • 已创建数据库集群的高权限账号或普通账号。具体操作请参见创建数据库账号。
  • 已经将需要访问PolarDB集群的主机IP地址添加到白名单，如何添加白名单请参见设置集群白名单。

通过DMS登录PolarDB

数据管理（Data Management Service，简称DMS）是一种集数据管理、结构管理、访问安全、BI图表、数据趋势、数据轨迹、性能与优化和服务器管理于一体的数据管理服务。支持对关系型数据库（MySQL、SQL Server、PostgreSQL等）和NoSQL数据库（MongoDB、Redis等）的管理，同时还支持Linux服务器管理。

  1. 登录PolarDB控制台。
  2. 在控制台左上角，选择集群所在地域。
  3. 找到目标集群，单击集群ID。
  4. 单击基本信息页面右上角的登录数据库。
  5. 在弹出的对话框中，输入PolarDB集群中创建的数据库账号和数据库密码。
    DMS登录实例
  6. 单击登录。
    说明 如果您是首次使用DMS连接PolarDB集群，系统会提示您授权白名单，单击确认后即可完成授权。
  7. 登录后刷新DMS页面，在左侧导航栏中，单击已登录实例。
  8. 找到目标数据库，双击目标数据库即可切换到目标数据库。

通过客户端连接PolarDB

您也可以通过pgAdmin 4客户端连接PolarDB数据库集群。

  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. 右键单击目标数据库，选择查询工具...，打开如下页面后，即可对数据库进行增删改查等操作。
    查询窗口

通过命令行连接PolarDB

除了上述连接PolarDB数据库集群的方式外，您还可以下载安装PostgreSQL客户端使用psql工具连接PolarDB数据库集群。

说明
  • Windows系统与Linux系统的psql工具连接PolarDB集群的方法一致。
  • 更多关于psql工具的使用方法，请参见psql。
  1. 在命令行中输入以下命令，然后按回车键。
    psql -U <username> -h <host> -p <port> <dbname>
    参数 描述
    username PolarDB集群的账号，创建账号请参见创建数据库账号。
    host

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

    1. 登录PolarDB控制台。
    2. 在控制台左上角，选择集群所在地域。
    3. 单击目标集群ID。
    4. 在链接地址区域查看PolarDB地址。
    port PolarDB集群端口，默认为1521。
    dbname 需要管理的维护数据库名称。如何新建数据库，请参见创建数据库。

    示例如下：

    psql -U testuser -h hostname -p 1521 testdb
  2. 输入username对应的密码，然后按回车键即可完成连接。

下一步

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