本文介绍如何通过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图标,将其移动到右侧已选节点框中。
    说明 节点的选择不影响读写模式:
    • 读写模式为可读可写(自动读写分离)时,无论已选节点是否选中主节点,写请求都只会发往主节点。
    • 读写模式为只读时,所有读请求按照负载均衡的方式转发到各只读节点,不会转发到主节点。即使主节点已被添加在已选节点中,也不会生效。
    新节点自动加入 新增的节点是否要自动添加到该地址中。
    负载均衡设置 负载均衡策略 读写分离时,在多个节点间用于处理读请求的调度策略,默认为基于负载的自动调度,且不可更改。
    主库是否接受读
    • 选择,查询SQL将仅发送到只读节点,来降低主节点的负载,确保主节点稳定。
    • 选择,查询SQL可以发送到主节点和只读节点。
    关于主库是否接受读的更多介绍,请参见主库是否接受读
    说明可读可写(自动读写分离)模式下支持该配置。
    事务拆分 开启或关闭事务拆分。关于事务拆分的更多介绍,请参见事务拆分
    说明可读可写(自动读写分离)模式下支持该配置。
    一致性设置 一致性级别
    • 读写模式为可读可写(自动读写分离)时,可选一致性级别有最终一致性(弱)会话一致性(中)全局一致性(强),详情请参见一致性级别
    • 读写模式为只读时,默认一致性级别为最终一致性(弱)且不可更改。
    说明 一致性级别修改后对所有连接立即生效。
    全局一致性读超时时间 等待只读节点同步到最新数据的超时时间,单位为ms。取值范围为0~6000 ms,默认取值为20 ms。
    说明 仅当一致性级别全局一致性(强)时支持该配置。
    全局一致性读超时策略 在只读节点等待超时后,PolarDB的默认策略,取值范围如下:
    • 0,发送该请求到主节点(默认值)
    • 1,SQL报错(wait replication complete timeout, please retry)
    说明 仅当一致性级别全局一致性(强)时支持该配置。
    连接池设置 连接池 您可以选择关闭(默认选项)、开启会话级连接池开启事务级连接池。关于连接池的更多介绍,请参见连接池
    说明 仅当读写模式为可读可写(自动读写分离)时支持该配置。
    HTAP优化 并行查询 开启或关闭并行查询,并设置并行度。并行查询默认关闭。详情请参见并行查询(Parallel Query)
    说明 仅当集群版本为PolarDB MySQL引擎8.0版本的集群地址在只读模式下支持该配置。
    行存/列存自动引流 开启或关闭行存和列存自动引流功能。详情请参见行存和列存自动分流
    说明 PolarDB MySQL引擎8.0.1版本且内核小版本需为8.0.1.1.22及以上的集群地址在可读可写(自动读写分离)模式下,且服务节点已选节点中包含了至少一个只读列存节点时,才支持该配置。
  6. 单击确定即可。

相关API

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