连接数据库集群

本文介绍如何通过DMS和客户端连接到PolarDB PostgreSQL版集群。

前提条件

  • 已创建数据库集群的高权限账号或普通账号。具体操作请参见创建数据库账号

  • 已经将需要访问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集群中创建的数据库账号数据库密码,单击登录

    image

    说明

    如果您是首次使用DMS连接PolarDB集群,系统会提示您授权白名单,单击确认后即可完成授权。

  6. 登录后刷新DMS页面,在左侧导航栏中,单击已登录实例

  7. 已登录实例列表中,单击目标集群名称,找到并双击目标数据库名称,即可切换到目标数据库进行管理。

通过客户端连接PolarDB

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

  1. 启动pgAdmin 4客户端。

  2. 右击Servers,选择创建 > 服务器 ,如下图所示。

    创建服务器

  3. 创建-服务器页面的常规标签页面中,自定义服务器名称

    pgadmin4-常规

  4. 选择连接标签页,输入要连接的集群信息,参数说明如下。

    pgadmin-连接

    表 1. 参数说明

    参数

    说明

    主机名称/地址

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

    1. 登录PolarDB控制台

    2. 在控制台左上角,选择集群所在地域。

    3. 单击目标集群ID。

    4. 链接地址区域查看PolarDB地址。

    端口

    需输入PolarDB PostgreSQL版集群端口,查看端口参考查看连接地址和端口

    维护数据库

    输入维护数据库,默认为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集群连接地址的具体操作请参见查看或申请连接地址

    port

    PolarDB集群端口,查看端口参考查看连接地址和端口

    dbname

    需要管理的维护数据库名称。如何新建数据库,请参见创建数据库

    示例如下:

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

解决连接失败的问题

  • 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