AI 助理
文档备案控制台
官方文档
首页

查看或申请连接地址

更新时间：
复制 MD 格式
产品详情
我的收藏

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版集群指产品版本为企业版或标准版的集群。

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

    该区域包含 主地址 和 集群地址【推荐】 两种连接方式，集群地址模式为 可读可写（自动读写分离）。每种地址均包含私网地址、公网地址和 EndpointId 信息，还可单击 创建自定义地址 新增连接。

    说明

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

    PolarDB PostgreSQL分布式版集群

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

    展开后的访问地址面板中包含公网地址（若暂无可单击申请）、私网地址和EndpointId三个字段，右侧还提供创建自定义地址入口。

申请公网地址

  1. 登录PolarDB控制台，在左侧导航栏单击集群列表，选择集群所在地域，并单击目标集群ID进入集群详情页。

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

    集中式PolarDB PostgreSQL版集群

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

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

      说明

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

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

      说明

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

      • 由小写字母、数字、中划线（-）组成，6~40个字符。

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

    PolarDB PostgreSQL分布式版集群

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

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

      说明

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

      • 由小写字母、数字、中划线（-）组成，6~40个字符。

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

下一步

连接数据库集群

相关API

API

描述

查询PolarDB集群的地址信息

查询集群的地址信息。

创建集群公网连接地址

创建集群的公网地址。

修改集群连接地址

修改集群默认访问地址。

释放集群公网地址

释放集群地址。
上一篇：连接数据库下一篇：修改或释放连接地址