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

前提条件

产品系列需为PolarDB MySQL版集群版高压缩引擎(X-Engine)单节点不支持该功能。更多关于3个系列的介绍,请参见产品系列

注意事项

PolarDB MySQL版8.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),提供了能够有效利用单节点内多核CPU进行并行加速的能力。详情请参见概述
    • 多机并行:提供了能够有效利用集群内所有节点的计算资源进行并行加速的能力。详情请参见弹性多机并行
    行存/列存自动引流开启或关闭行存和列存自动引流功能。详情请参见行存和列存自动分流
    说明 PolarDB MySQL版8.0.1版本且内核小版本需为8.0.1.1.22及以上的集群地址在可读可写(自动读写分离)模式下,且服务节点已选节点中包含了至少一个只读列存节点时,才支持该配置。
    安全防护是否开启过载保护开启或者关闭过载保护功能。详情请参见过载保护
  6. 单击确定即可。

相关API

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