本文介绍如何通过PolarDB的集群地址来配置数据库代理。

前提条件

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

注意事项

  • PolarDB MySQL引擎8.0版本集群在配置数据库代理时支持开启并行查询和设置并行度。
  • 对于数据库代理(PolarProxy)版本为1.6.0及以上版本的PolarDB MySQL引擎集群,您可以直接新增自定义集群地址;若您需要为1.6.0之前版本的集群新增自定义地址,请提交工单联系售后服务。

操作步骤

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

相关API

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