您可以在PolarDB控制台上管理集群地址,如创建和释放自定义集群地址,或修改集群地址的配置等。本文介绍如何管理PolarDB集群地址。

前提条件

产品系列需为PolarDB MySQL集群版单节点历史库均不支持该功能。更多关于3个系列的介绍,请参见产品系列

注意事项

  • 一个PolarDB集群最多可以有4个(1个默认和3个自定义)集群地址。
  • 默认集群地址仅支持修改地址配置,但无法被释放,自定义集群地址可以被释放。
  • PolarDB MySQL 8.0集群在配置集群地址时支持开启并行查询和设置并行度。
  • 对于2019年04月29日起创建的集群,您可以直接新增自定义集群地址。若您需要为2019年04月29日之前创建的集群新增自定义地址,请提交工单联系售后服务。

新增自定义集群地址

  1. 登录PolarDB控制台
  2. 在控制台左上角,选择集群所在地域。
  3. 找到目标集群,单击集群ID。
  4. 在集群基本信息页的链接地址区域,单击创建自定义地址
  5. 创建自定义地址对话框内,设置如下配置。
    表 1. 配置表
    配置项 说明
    网络信息 PolarDB为每个集群地址默认提供了公网连接地址,若需要修改该地址或申请私网和经典网络连接地址,请参见修改连接地址和端口申请连接地址
    集群设置 读写模式 本地址的读写模式,可选模式为只读可读可写(自动读写分离)
    说明 创建自定义地址后还可以修改读写模式。修改读写模式后,只对新建连接生效,已有的连接保持原来的模式。
    地址名称 输入集群地址的名称。
    服务节点 可选节点已选节点 从左侧可选节点框内,选中想要加入本地址用于处理读请求的节点,单击1图标,将其移动到右侧已选节点框中。
    说明
    • 可选节点包括主节点和所有只读节点。
    • 节点的选择不影响读写模式。读写模式为可读可写(自动读写分离)时,无论是否选中主节点,写请求都只会发往主节点。
    • PolarDB支持创建仅包含一个节点的集群地址,但当读写模式为只读时,不允许创建仅包含一个主节点的单节点集群地址。更多详情,请参见读写模式
    新节点自动加入 新增的节点是否要自动添加到该地址中。
    负载均衡设置 负载均衡策略 读写分离时,在多个节点间用于处理读请求的调度策略,默认为基于负载的自动调度,且不可更改。
    主库保护 开启之后,查询SQL将仅发送到只读节点,来降低主节点的负载,确保主节点稳定。 关于主库保护的更多介绍,请参见读写分离
    说明可读可写(自动读写分离)模式下支持该配置。
    事务拆分 开启或关闭事务拆分。关于事务拆分的更多介绍,请参见事务拆分
    说明 仅当读写模式为可读可写(自动读写分离)一致性级别会话一致性(中)全局一致性(强)时,支持该配置。
    一致性设置 一致性级别
    • 读写模式为可读可写(自动读写分离)时,可选一致性级别有最终一致性(弱)会话一致性(中)全局一致性(强),详情请参见一致性级别
    • 读写模式为只读时,默认一致性级别为最终一致性(弱)且不可更改。
    说明 一致性级别修改后对所有连接立即生效。
    全局一致性读超时时间 等待只读节点同步到最新数据的超时时间,单位为ms。取值范围为0~6000 ms,默认取值为20 ms。
    说明 仅当一致性级别全局一致性(强)时支持该配置。
    全局一致性读超时策略 在只读节点等待超时后,PolarDB的默认策略,取值范围如下:
    • 0,发送该请求到主节点(默认值)
    • 1,SQL报错(wait replication complete timeout, please retry)
    说明 仅当一致性级别全局一致性(强)时支持该配置。
    连接池设置 连接池 您可以选择关闭(默认选项)、会话级事务级。关于连接池的更多介绍,请参见连接池
    说明 仅当读写模式为可读可写(自动读写分离)时支持该配置。
    HTAP优化 并行查询 开启或关闭并行查询,详情请参见并行查询(Parallel Query)
    说明 仅当集群版本为PolarDB MySQL 8.0的自定义集群地址在只读模式下支持该配置。
  6. 单击确定

修改集群地址

  1. 登录PolarDB控制台
  2. 在控制台左上角,选择集群所在地域。
  3. 找到目标集群,单击集群ID。
  4. 在集群基本信息页的链接地址区域,找到目标集群地址,单击目标集群地址名称右侧的编辑配置
  5. 在弹出的对话框内,根据业务需要修改集群地址的配置。具体配置项,请参见配置表
  6. 单击确定即可。

释放自定义集群地址

  1. 登录PolarDB控制台
  2. 在控制台左上角,选择集群所在地域。
  3. 找到目标集群,单击集群ID。
  4. 在集群基本信息页的链接地址区域,找到目标集群地址,单击目标集群地址名称右侧的释放
    说明 仅自定义集群地址可以被释放,默认集群地址无法被释放。
  5. 在弹出的对话框中,单击确定

相关API

API 描述
DescribeDBClusterEndpoints 查询集群地址。
ModifyDBClusterEndpoint 修改集群地址。
DeleteDBClusterEndpoint 释放自定义集群地址。