并行查询配置参数说明

参数名

级别

描述

max_parallel_degree

Global、Session

单个查询的最大并行度，即并行执行的最大Worker数量。

• 取值范围：[0-1024]；

• 默认值：0，表示关闭并行查询。

parallel_degree_policy

Global

设置单个查询的并行度配置策略，取值范围如下：

• TYPICAL：PolarDB选择查询并行度时不会考虑数据库负载（如CPU使用率等），而尽可能与max_parallel_degree设置的并行度保持一致。

• AUTO：PolarDB会根据数据库负载（如CPU使用率等）来决定是否禁止并行查询计划，并会根据查询代价选择并行度。

• REPLICA_AUTO（默认）：仅只读节点会根据数据库负载（如CPU使用率等）决定是否禁止并行查询计划，并会根据查询代价选择并行度，而主节点不会开启并行查询。

parallel_workers_policy

session

records_threshold_for_parallelism

Session

若优化器估算出语句中存在扫描记录数超过该阈值的表，优化器会考虑选择并行执行计划。

• 取值范围：[0-18446744073709551615]；

• 默认值：10000。

cost_threshold_for_parallelism

Session

若优化器估算查询的串行执行代价超过该阈值，优化器会考虑选择并行执行计划。

• 取值范围：[0-18446744073709551615]；

• 默认值：50000。

records_threshold_for_mpp

session

查询语句中表扫描行数超过该阈值后，优化器会考虑选择多机并行执行方式。

• 取值范围：[0-18446744073709551615]；

• 默认为0，含义是自动取值records_threshold_for_parallelism的N倍，N为ePQ集群的节点个数。

cost_threshold_for_mpp

session

查询语句的串行执行代价超过该阈值后，优化器会考虑选择多机并行执行方式。

• 取值范围：[0-18446744073709551615]；

• 默认值为0，含义是自动取值cost_threshold_for_parallelism的N倍，N为节点个数。

变量名

级别

描述

Parallel_workers_created

Session、Global

从Session启动开始，生成Parallel Worker的个数。

Gather_records

Session、Global

Gather记录总数。

PQ_refused_over_total_workers

Session、Global

由于总Worker数限制没有启用并行的查询数。

PQ_refused_over_max_queuing_time

Session、Global

由于并行查询排队超时没有启动并行的查询数。

Total_running_parallel_workers

Global

当前正在运行的Parallel Worker的数目。