查看或申请连接地址

PolarDB集群的连接地址(又称为Endpoint)分为主地址、集群地址(又称为默认集群地址)和自定义地址三种类型。在连接PolarDB集群时,您可以填写PolarDB集群的上述三种地址,推荐使用默认集群地址。

连接地址

  • 集中式PolarDB PostgreSQL集群(产品版本企业版标准版

    image
  • PolarDB PostgreSQL分布式版集群

    image

地址类型

地址说明

支持的网络类型

集群地址(推荐)

创建集中式PolarDB PostgreSQL集群(产品版本企业版标准版)时,每个集群会包含一个默认的集群地址。该地址的服务由数据库代理提供。

默认集群地址支持自动读写分离,即写请求路由到主节点,读请求路由到只读节点。关于数据库代理的说明,请参见数据库代理

说明

PolarDB PostgreSQL分布式版集群不包含该默认集群地址。

  • 私网

  • 公网

主地址

每个PolarDB集群均支持且仅支持1个主地址。主地址有以下特点:

  • 总是连接到主节点或主CN节点,支持读和写操作。

  • 当主节点或主CN节点发生故障时,主地址会自动切换到新的主节点。

自定义地址

  • 集中式PolarDB PostgreSQL集群

    产品版本企业版标准版PolarDB集群。

    • 最多可以再创建5个自定义地址。这些地址的服务也由数据库代理提供。

    • 自定义地址可以配置读写模式及负载均衡策略,既可支持读写分离,也可支持纯只读的业务。详细的配置请参见配置数据库代理

    • 自定义地址最少能够挂载一个只读节点,通过这个地址的请求只会到达这个只读节点。

    说明

    PolarDB支持创建单节点的自定义地址。若此节点故障,该集群地址可能会有最多1小时的不可用,请勿用于生产环境。

  • PolarDB PostgreSQL分布式版集群

    • 最多可以再创建6个自定义地址。

    • 自定义的多CN统一地址不能用于执行DDL语句(例如表创建/删除、账户创建/删除),适用于执行DML/DQL。DDL语句请使用主地址执行。

私网地址和公网地址

网络类型

说明

使用场景

私网

  • 通过私网的连接地址访问可以发挥PolarDB的最佳性能。

  • 创建集群时,默认生成的连接地址包含一个私有网络连接地址。该地址无法释放,但支持修改。关于如何修改,请参见修改连接地址

例如:

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

  • 使用DMS通过VPC访问数据库集群。

公网

  • 您可以申请或释放公网的连接地址,详情请参见申请公网地址

  • 公网即因特网,通过公网访问将无法实现PolarDB最佳性能。

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

查看连接地址和端口

  1. 登录PolarDB控制台,选择集群所在地域,在集群列表中单击目标集群ID进入详情页。

  2. 您可以根据集群类型选择相应方式查看连接地址和端口。

    集中式PolarDB PostgreSQL集群

    集中式PolarDB PostgreSQL集群指产品版本企业版标准版的集群。

    数据库连接区域,将鼠标移动到目标地址位置,即可在弹出的对话框中查看网络信息,包括连接地址和端口号。

    image

    说明

    如果您之前是通过域名连接到数据库,当数据库迁移上云后,想要保留原来的数据库域名,可以单击绑定私有域名进行绑定。仅私网的连接地址支持设置私有域名绑定。具体内容,请参见私有域名

    PolarDB PostgreSQL分布式版集群

    数据库连接区域,将鼠标移动到目标私网或公网地址位置,即可在弹出的对话框中连接地址和端口号。

    image

申请公网地址

  1. 登录PolarDB控制台,选择集群所在地域,在集群列表中单击目标集群ID进入详情页。

  2. 您可以根据集群类型选择相应方式申请连接地址。

    集中式PolarDB PostgreSQL集群

    集中式PolarDB PostgreSQL集群指产品版本企业版标准版的集群。

    1. 在集群基本信息页面的数据库连接区域,找到目标地址,单击目标地址中公网右侧的申请

      image

      说明

      仅支持申请公网连接地址。在创建集群和自定义地址时,默认生成一个私网连接地址,因此该地址无需申请。

    2. 在弹出的对话框中,设置连接地址前缀,单击确定

      说明

      连接地址前缀需满足如下条件:

      • 由小写字母、数字、中划线(-)组成,6~40个字符。

      • 以字母开头,以数字或字母结尾。

    PolarDB PostgreSQL分布式版集群

    1. 在集群基本信息页面的数据库连接区域,找到目标地址,单击目标地址中公网地址右侧的请点击申请

      image

    2. 在弹出的对话框中,设置连接地址前缀,单击确定

      说明

      连接地址前缀需满足如下条件:

      • 由小写字母、数字、中划线(-)组成,6~40个字符。

      • 以字母开头,以数字或字母结尾。

下一步

连接数据库集群

相关API

API

描述

DescribeDBClusterEndpoints - 查询PolarDB集群的地址信息

查询集群的地址信息。

CreateDBEndpointAddress - 创建集群公网连接地址

创建集群的公网地址。

ModifyDBEndpointAddress - 修改集群连接地址

修改集群默认访问地址。

DeleteDBEndpointAddress - 释放集群公网地址

释放集群地址。