---
title: 使用 PARALLEL(n) Hint 实际使用的并行线程不符合预期-OceanBase数据库使用指南
description: 了解OceanBase数据库在实际应用中关于 使用 PARALLEL(n) Hint 实际使用的并行线程不符合预期相关的常见问题和使用技巧，帮助您快速解决 使用 PARALLEL(n) Hint 实际使用的并行线程不符合预期的难题。
---
切换语言

- 简体中文
- English

划线反馈

# 使用 PARALLEL(n) Hint 实际使用的并行线程不符合预期

更新时间：2026-05-15 09:06

适用版本： V1.4.x、V2.1.x、V2.2.x、V3.1.x、V3.2.x、V4.0.x、V4.1.x、V4.2.x 内容类型：Troubleshoot  

## 适用版本

OceanBase 数据库所有版本。

## 问题现象

SQL 语句中使用 PARALLEL(16) Hint 期望使用的并行线程数为 16。

![hint](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/database/sql/58d3301e-3b33-40f2-aae7-00558cb6dd99.png)

但是查询发现实际使用的并行线程数为 3。

![hint](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/database/sql/1c1e2525-de5f-485d-8e79-c480b098ed61.png)

并且 SQL 执行的耗时较高。

![hint](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/database/sql/22231942-200c-496f-9631-bff3e3541368.png)

## 问题原因

查看系统变量 `parallel_servers_target` 和 `parallel_max_servers`，发现变量的值均为 3，两变量默认值均为 0，应该是被主动修改过导致使用 PARALLEL(16) Hint 的最大并行线程数为 3。

![hint](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/database/sql/35c017fc-3e11-4fc5-99c4-4a045636a68a.png)

变量说明：

- `parallel_servers_target` 用于设置每个 Server 上的并行查询排队条件。当多条并行执行（Parallel eXecution，PX）SQL 总计消耗的线程数超过并行查询排队条件后，后继并行执行 SQL 需要排队等待。这个值会在创建租户时自动设定。
 - `parallel_max_servers` 用于设置每台 Server 上并行执行（Parallel eXecution，PX）线程池中的最大线程数。该变量在 V3.x 及之后的版本不再使用。

## 解决方法

修改这两个变量的值为 32，发现 PARALLEL(16) Hint 生效，执行时间在正常范围。

![hint](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/database/sql/a96b7803-d98b-49e0-a4e1-a36665a57e92.png)

## 相关文档

- [与并行执行相关的 Hint](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000037456)
 - [系统变量 parallel_servers_target](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000035551)
 - [系统变量 parallel_max_servers](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000035470)

Previous

[如何创建 Outline 并验证 Outline 生效](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000001387450)

Next

[Queuing 表查询缓慢问题](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000000209901) ![有帮助](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) 咨询热线