---
title: "并行查询的参数调优 - OceanBase 数据库 V4.5.0 | OceanBase 文档中心"
description: 并行查询的参数调优 并行查询（PX）的参数（变量或配置项）决定了并行查询的速度，主要包括并行度和 EXCHANGE 相关参数。 并行度变量 并行度相关变量主要决定每个查询并发时的 Worker 个数。 变量名称 描述 取值范围 默认值 配置建议 parallel_servers_target 当准备排队之前，检查查询…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.5.0

# 并行查询的参数调优

更新时间：2026-04-24 14:12:15

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.5.0/zh-CN/700.reference/1000.performance-tuning-guide/500.sql-optimization/300.distributed-execution-plan/900.optimize-the-parameters-for-parallel-query.md)  

并行查询（PX）的参数（变量或配置项）决定了并行查询的速度，主要包括并行度和 `EXCHANGE` 相关参数。

## 并行度变量

并行度相关变量主要决定每个查询并发时的 Worker 个数。

| **变量名称** | **描述** | **取值范围** | **默认值** | **配置建议** |
| --- | --- | --- | --- | --- |
| parallel_servers_target | 当准备排队之前，检查查询要求的并行度和已统计的 Worker 总和是否超过该值。如果超过该值，则查询需要排队，否则查询继续执行。 | [0, 9223372036854775807] | 0（目前会根据 CPU 个数计算得到，以实际大小为准） | 该变量主要是控制 PX 场景下，当准备进行并行查询时，如果没有足够 Worker 处理该查询，决定是否继续进行还是排队等待。 |

可以通过 `SHOW VARIABLES` 来查看这些变量的值，如下例所示：

```sql
obclient> SHOW VARIABLES LIKE '%paral%';

+-------------------------+-------+
| Variable_name           | Value |
+-------------------------+-------+
| parallel_servers_target | 4     |
+-------------------------+-------+
1 rows in set

```

## EXCHANGE（Shuffle）配置项

`EXCHANGE`（Shuffle）配置项主要用于控制 DFO（Distributed Function Operator）之间数据传输时的内存管理和数据重分布策略，也就是数据进行 Shuffle 时的内存控制。OceanBase 数据库将数据传输封装成了叫做 DTL（Data Transfer layer）的模块。

| **配置项名称** | **描述** | **取值范围** | **默认值** | **配置建议** |
| --- | --- | --- | --- | --- |
| dtl_buffer_size | 控制 `EXCHANGE` 算子之间（即 Transmit 和 Receive 之间）发送数据时，每次发送数据的 Buffer 的大小。即当数据达到了该值上限才进行发送，减少每行传输的代价。 | [4k, 2M] | 64K | PX 场景下，`EXCHANGE` 之间发送数据依赖于该配置项大小，一般不需要调整该配置项，如果是为了减少发送数据次数等可以尝试进行修改，一般不建议修改该值大小。 |

可以通过 `SHOW PARAMETERS` 来查看配置项的值，如下例所示：

```SQL
obclient> SHOW PARAMETERS LIKE '%dtl%'\G
*************************** 1. row ***************************
      zone: zone1
  svr_type: observer
    svr_ip: 172.xx.xxx.xxx
  svr_port: 2882
      name: dtl_buffer_size
 data_type: CAPACITY
     value: 64K
      info: to be removed
   section: OBSERVER
     scope: CLUSTER
    source: DEFAULT
edit_level: DYNAMIC_EFFECTIVE
1 row in set

```

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线
