Skip to content

Commit 6752e51

Browse files
Update parallelism-tuning.md (#3379)
## Summary - Recreate the `SET_VAR` SQL hint syntax fix from #2511 by removing extra quotes around parameters. - Apply this fix to `dev`, `3.x`, and `4.x` docs for both English and Chinese. ## Versions - [x] dev - [x] 4.x - [x] 3.x - [ ] 2.1 - [ ] 2.0 ## Languages - [x] Chinese - [x] English ## Reference - Original PR: #2511 Co-authored-by: yuanyuan8983 <99315889+yuanyuan8983@users.noreply.github.com>
1 parent bc0e6fe commit 6752e51

8 files changed

Lines changed: 16 additions & 19 deletions

File tree

docs/query-acceleration/tuning/tuning-execution/parallelism-tuning.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -37,8 +37,8 @@ Doris allows users to manually specify the parallelism of a query to adjust the
3737
Use SQL HINT to specify the parallelism of a single SQL statement. This allows for flexible control of the parallelism of different SQL statements to achieve the best execution results.
3838

3939
```sql
40-
select /*+SET_VAR("parallel_pipeline_task_num=8")*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
41-
select /*+SET_VAR("parallel_pipeline_task_num=8,runtime_filter_mode=global")*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
40+
select /*+SET_VAR(parallel_pipeline_task_num=8)*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
41+
select /*+SET_VAR(parallel_pipeline_task_num=8,runtime_filter_mode=global)*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
4242
```
4343

4444
### Session Level Adjustment

i18n/zh-CN/docusaurus-plugin-content-docs/current/query-acceleration/tuning/parallelism-tuning.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -46,8 +46,8 @@ Doris 可以手动指定查询的并行度,以调整查询执行时并行执
4646
通过 SQL HINT 来指定单个 SQL 的并行度,这样可以灵活控制不同 SQL 的并行度来取得最佳的执行效果
4747

4848
```SQL
49-
select /*+SET_VAR("parallel_pipeline_task_num=8")*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
50-
select /*+SET_VAR("parallel_pipeline_task_num=8,runtime_filter_mode=global")*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
49+
select /*+SET_VAR(parallel_pipeline_task_num=8)*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
50+
select /*+SET_VAR(parallel_pipeline_task_num=8,runtime_filter_mode=global)*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
5151
```
5252

5353
#### 会话级别调整:
@@ -65,4 +65,3 @@ set parallel_pipeline_task_num = 8;
6565
```SQL
6666
set global parallel_pipeline_task_num = 8;
6767
```
68-

i18n/zh-CN/docusaurus-plugin-content-docs/current/query-acceleration/tuning/tuning-execution/parallelism-tuning.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -46,8 +46,8 @@ Doris 可以手动指定查询的并行度,以调整查询执行时并行执
4646
通过 SQL HINT 来指定单个 SQL 的并行度,这样可以灵活控制不同 SQL 的并行度来取得最佳的执行效果
4747

4848
```SQL
49-
select /*+SET_VAR("parallel_pipeline_task_num=8")*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
50-
select /*+SET_VAR("parallel_pipeline_task_num=8,runtime_filter_mode=global")*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
49+
select /*+SET_VAR(parallel_pipeline_task_num=8)*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
50+
select /*+SET_VAR(parallel_pipeline_task_num=8,runtime_filter_mode=global)*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
5151
```
5252

5353
### 会话级别调整
@@ -142,4 +142,3 @@ set parallel_pipeline_task_num = 16;
142142

143143
1. 建议从 CPU 利用率出发。通过 PROFILE 工具输出观察是否是 CPU 瓶颈,尝试进行并行度的合理修改
144144
2. 单 SQL 调整比较安全,尽量不要全局做过于激进的修改
145-

i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/query-acceleration/tuning/tuning-execution/parallelism-tuning.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -43,8 +43,8 @@ Doris 可以手动指定查询的并行度,以调整查询执行时并行执
4343
通过 SQL HINT 来指定单个 SQL 的并行度,这样可以灵活控制不同 SQL 的并行度来取得最佳的执行效果
4444

4545
```SQL
46-
select /*+SET_VAR("parallel_pipeline_task_num=8")*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
47-
select /*+SET_VAR("parallel_pipeline_task_num=8,runtime_filter_mode=global")*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
46+
select /*+SET_VAR(parallel_pipeline_task_num=8)*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
47+
select /*+SET_VAR(parallel_pipeline_task_num=8,runtime_filter_mode=global)*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
4848
```
4949

5050
### 会话级别调整

i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/query-acceleration/tuning/parallelism-tuning.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -45,8 +45,8 @@ Doris 可以手动指定查询的并行度,以调整查询执行时并行执
4545
通过 SQL HINT 来指定单个 SQL 的并行度,这样可以灵活控制不同 SQL 的并行度来取得最佳的执行效果
4646

4747
```SQL
48-
select /*+SET_VAR("parallel_pipeline_task_num=8")*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
49-
select /*+SET_VAR("parallel_pipeline_task_num=8,runtime_filter_mode=global")*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
48+
select /*+SET_VAR(parallel_pipeline_task_num=8)*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
49+
select /*+SET_VAR(parallel_pipeline_task_num=8,runtime_filter_mode=global)*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
5050
```
5151

5252
#### 会话级别调整:

i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/query-acceleration/tuning/tuning-execution/parallelism-tuning.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -37,8 +37,8 @@ Doris 可以手动指定查询的并行度,以调整查询执行时并行执
3737
通过 SQL HINT 来指定单个 SQL 的并行度,这样可以灵活控制不同 SQL 的并行度来取得最佳的执行效果
3838

3939
```SQL
40-
select /*+SET_VAR("parallel_pipeline_task_num=8")*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
41-
select /*+SET_VAR("parallel_pipeline_task_num=8,runtime_filter_mode=global")*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
40+
select /*+SET_VAR(parallel_pipeline_task_num=8)*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
41+
select /*+SET_VAR(parallel_pipeline_task_num=8,runtime_filter_mode=global)*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
4242
```
4343

4444
### 会话级别调整

versioned_docs/version-3.x/query-acceleration/tuning/tuning-execution/parallelism-tuning.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -46,8 +46,8 @@ Doris allows users to manually specify the parallelism of a query to adjust the
4646
Use SQL HINT to specify the parallelism of a single SQL statement. This allows for flexible control of the parallelism of different SQL statements to achieve the best execution results.
4747

4848
```sql
49-
select /*+SET_VAR("parallel_pipeline_task_num=8")*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
50-
select /*+SET_VAR("parallel_pipeline_task_num=8,runtime_filter_mode=global")*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
49+
select /*+SET_VAR(parallel_pipeline_task_num=8)*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
50+
select /*+SET_VAR(parallel_pipeline_task_num=8,runtime_filter_mode=global)*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
5151
```
5252

5353
### Session Level Adjustment
@@ -142,4 +142,3 @@ Usually, users do not need to adjust the query parallelism. If adjustment is req
142142

143143
1. It is recommended to start from the CPU utilization. Observe whether it is a CPU bottleneck through the PROFILE tool output and try to make reasonable modifications to the parallelism.
144144
2. Adjusting a single SQL is relatively safe. Try not to make overly aggressive global modifications.
145-

versioned_docs/version-4.x/query-acceleration/tuning/tuning-execution/parallelism-tuning.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -43,8 +43,8 @@ Doris allows users to manually specify the parallelism of a query to adjust the
4343
Use SQL HINT to specify the parallelism of a single SQL statement. This allows for flexible control of the parallelism of different SQL statements to achieve the best execution results.
4444

4545
```sql
46-
select /*+SET_VAR("parallel_pipeline_task_num=8")*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
47-
select /*+SET_VAR("parallel_pipeline_task_num=8,runtime_filter_mode=global")*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
46+
select /*+SET_VAR(parallel_pipeline_task_num=8)*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
47+
select /*+SET_VAR(parallel_pipeline_task_num=8,runtime_filter_mode=global)*/ * from nation, lineitem where lineitem.l_suppkey = nation.n_nationkey
4848
```
4949

5050
### Session Level Adjustment

0 commit comments

Comments
 (0)