配置数据库代理

前提条件

产品系列需为PolarDB MySQL版集群版。更多关于产品系列的介绍，请参见企业版产品系列。

注意事项

仅PolarDB MySQL版8.0版本的集群在配置数据库代理时支持开启并行查询和设置并行度。

操作步骤

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

2. 在集群基本信息页的数据库连接区域，找到目标集群地址，单击目标集群地址名称右侧的配置。

   

3. 在弹出的对话框内，根据业务需要修改集群地址的配置。具体配置项如下表所示：

   表 1. 配置表

   配置项		说明
   网络信息		PolarDB为每个集群地址默认提供了私网连接地址，若需要修改该地址或申请公网连接地址请参见管理连接地址。
   集群设置	读写模式	集群地址的读写模式，可选模式为只读和可读可写（自动读写分离）。 说明 创建自定义地址后还可以修改读写模式。修改读写模式后，只对新建连接生效，已有的连接保持原来的模式。
   	地址名称	输入集群地址的名称。
   服务节点	可选节点和已选节点	从左侧可选节点框内（包括主节点和所有只读节点），选中想要加入集群地址用于处理读请求的节点，单击图标，将其移动到右侧已选节点框中。 说明 节点的选择不影响读写模式： 读写模式为可读可写（自动读写分离）时，无论已选节点是否选中主节点，写请求都只会发往主节点。 读写模式为只读时，所有读请求按照负载均衡的方式转发到各只读节点，不会转发到主节点。即使主节点已被添加在已选节点中，也不会生效。
   	新节点自动加入	新增的节点是否要自动添加到该地址中。
   负载均衡设置	负载均衡策略	读写分离时，在多个节点间用于处理读请求的调度策略。可选策略为基于连接数负载均衡和基于活跃请求数负载均衡。关于负载均衡策略的更多介绍请参见负载均衡策略。
   	主库是否接受读	选择否，查询SQL将仅发送到只读节点，来降低主节点的负载，确保主节点稳定。 选择是，查询SQL可以发送到主节点和只读节点。 关于主库是否接受读的更多介绍请参见主库是否接受读。 说明 仅可读可写（自动读写分离）模式下支持该配置。
   	事务拆分	开启或关闭事务拆分。关于事务拆分的更多介绍请参见事务拆分。 说明 仅可读可写（自动读写分离）模式下支持该配置。
   	按需建联	开启或关闭按需建联功能。关于按需建联的更多介绍请参见按需建连。 说明 仅负载均衡策略为基于活跃请求数负载均衡时支持该配置。
   一致性设置	一致性级别	读写模式为可读可写（自动读写分离）时，可选一致性级别有最终一致性（弱）、会话一致性（中）和全局一致性（强），详情请参见一致性级别。 读写模式为只读时，默认一致性级别为最终一致性（弱）且不可更改。 重要 一致性级别修改后对所有连接立即生效。 全局一致性（高性能模式）需要在集群中所有地址同时生效，如果要选择非全局一致性（高性能模式），则集群其他所有地址都会回退至开启全局一致性（高性能模式）之前的一致性状态。
   	全局一致性读超时时间	等待只读节点同步到最新数据的超时时间。取值范围：0~60000。默认值为20。单位为ms。 说明 仅当一致性级别为全局一致性（强）且全局一致性模式为传统模式时支持该配置。
   	全局一致性读超时策略	在只读节点等待超时后PolarDB的默认策略，取值范围如下： 0，发送该请求到主节点（默认值） 1，SQL报错（wait replication complete timeout, please retry） 说明 仅当一致性级别为全局一致性（强）且全局一致性模式为传统模式时支持该配置。
   	全局一致性读超时时间（高性能模式）	等待只读节点同步到最新数据的超时时间。取值范围：1~1000000。默认值为100。单位为ms。 重要 全局一致性（高性能模式）需要在集群中所有地址同时生效，如果在某个地址开启全局一致性（高性能模式），则集群其他所有地址都会开启全局一致性（高性能模式）。 仅当一致性级别为全局一致性（强）且全局一致性模式为高性能模式时支持该配置。
   	全局一致性读超时策略（高性能模式）	在只读节点等待超时后PolarDB的默认策略，取值范围如下： 0，发送该请求到主节点（默认值） 1，超时报错，客户端返回错误提示信息 2，超时降级，当全局一致性读超时后，本次查询操作会自动降级为非一致性读取，且客户端不会收到报错信息 说明 仅当一致性级别为全局一致性（强）且全局一致性模式为高性能模式时支持该配置。
   	会话一致性读超时时间	等待只读节点同步到最新数据的超时时间。取值范围：0~60000。默认值为0。单位为ms。 重要 仅当一致性级别为会话一致性（中）时支持该配置。 全局一致性（高性能模式）需要在集群中所有地址同时生效，如果要选择非全局一致性（高性能模式），则集群其他所有地址都会回退至开启全局一致性（高性能模式）之前的一致性状态。
   	会话一致性读超时策略	在只读节点等待超时后PolarDB的默认策略，取值范围如下： 0，发送该请求到主节点（默认值） 1，SQL报错（wait replication complete timeout, please retry） 说明 仅当一致性级别为会话一致性（中）时支持该配置。
   连接池设置	连接池	您可以选择关闭（默认）、会话级或事务级。关于连接池的更多介绍请参见连接池。 说明 仅当读写模式为可读可写（自动读写分离）时支持该配置。 连接池的配置修改仅对新建立的连接生效。通常情况下，为了使修改生效，需要重启应用程序或重建与数据库的连接。
   HTAP优化	并行查询	开启或关闭并行查询功能，并设置并行度。 开启弹性并行查询（ePQ）能够有效利用多核CPU（集群内空闲计算资源）的并行处理能力，对复杂查询进行加速，详情请参见弹性并行查询。 说明 自2023年4月1日起，集群满足以下条件时会默认开启弹性并行查询，且默认的并行度为2： 新创建的集群：集群的CPU核数大于等于8。 存量集群：在存量集群中创建自定义集群地址，且集群的CPU核数大于等于8。
   	行存/列存自动引流	开启或关闭行存和列存自动引流功能。详情请参见配置行列自动分流。 说明 PolarDB MySQL版8.0.1版本且内核小版本需为8.0.1.1.22及以上的集群地址在可读可写（自动读写分离）模式下，且服务节点的已选节点中包含了至少一个只读列存节点时，才支持该配置。
   	列存节点接受OLTP请求	开启或关闭列存节点接受OLTP请求的能力。 开启列存节点接受OLTP请求的能力后，列存节点将同时接受OLAP和OLTP请求，数据库代理会根据活跃请求数，将OLTP类读请求路由至列存节点，这可能会导致列存节点的负载上升。 说明 仅当行存/列存自动引流为开启状态时支持该配置。
   安全防护	过载保护	开启或关闭过载保护功能。详情请参见过载保护。

4. 单击确定即可。

相关API