全部产品

云原生数据库 PolarDB：查看或申请连接地址

更新时间：Jul 26, 2024

在连接PolarDB集群时，您需要填写PolarDB集群的连接地址。PolarDB为集群地址和主地址分别提供了私网和公网的连接地址，本文将介绍如何在控制台查看和申请连接地址。

集群地址和主地址

连接地址示意图

地址类型	地址说明	支持的网络类型
集群地址（推荐）	应用程序只需连接一个集群地址，即可连接到多个节点。带有读写分离功能，写请求会自动发往主节点，读请求会自动根据各节点的负载发往主节点或只读节点。说明 PolarDB包含一个默认的集群地址，您还可以根据业务需求创建多个自定义的集群地址，自定义集群地址可以连接到指定的节点，以及设置读写模式等。具体信息，请参见创建自定义集群地址。	私网公网
主地址	总是连接到主节点，支持读和写操作。当主节点发生故障时，主访问地址会自动切换到新的主节点。	私网公网

私网地址和公网地址

网络类型

说明

使用场景

私网

通过私网的连接地址访问可以发挥PolarDB的最佳性能。
创建集群时会默认生成一个私网的连接地址，该地址支持修改但无法释放，关于如何修改，请参见修改连接地址。

例如：

ECS与数据库集群位于同一VPC，那么ECS可以通过私网地址访问数据库集群。
使用DMS访问数据库集群。

公网

您可以申请或释放公网的连接地址。具体操作，请参见申请连接地址和释放连接地址。
公网即因特网，通过公网访问将无法实现PolarDB最佳性能。

例如：通过公网访问数据库集群进行维护操作。

查看连接地址和端口

登录PolarDB控制台。
在左上角，选择集群所在地域。
找到目标集群，单击集群ID。
在基本信息页面的链接地址区域，您可以通过以下任意一种方式来查看连接地址和端口信息。
- 方式一
  单击链接地址区域右上角的图标切换视图，即可查看目标连接地址和端口信息。
- 方式二
  单击目标集群地址右侧的配置，即可在弹出的对话框中查看网络信息，包括连接地址和端口号。
说明
如果您之前是通过域名连接到数据库，当数据库迁移上云后，想要保留原来的数据库域名，可以单击绑定私有域名进行绑定。仅私网的连接地址支持设置私有域名绑定。具体内容，请参见私有域名。

申请连接地址

登录PolarDB控制台。
在左上角，选择集群所在地域。
找到目标集群，单击集群ID。
在基本信息页面的链接地址区域，您可以通过以下任意一种方式来查看连接地址和端口信息。
单击申请。
- 方式一：
  1. 单击链接地址区域右上角图标切换视图。
  2. 单击申请。
- 方式二：
  1. 单击目标集群地址右侧的配置。
  2. 在弹出的对话框中的网络信息区域，单击申请。
说明
- 仅支持申请公网的连接地址。
- 创建集群时会默认生成一个私网地址，无需申请。
在弹出的对话框中，设置连接地址前缀，单击确定。
说明
连接地址前缀需满足如下条件：
- 由小写字母、数字、中划线（-）组成，6~30个字符。
- 以字母开头，以数字或字母结尾。

下一步

连接数据库集群

相关API

API	描述
DescribeDBClusterEndpoints	查询集群的地址信息。
CreateDBEndpointAddress	创建集群的公网地址。
ModifyDBEndpointAddress	修改集群默认访问地址。
DeleteDBEndpointAddress	释放集群地址。