Skip to content

Commit 288d1f5

Browse files
authored
Update system-variables tidb_ddl_reorg_batch_size and tidb_ddl_reorg_… (#20941)
1 parent 2950f40 commit 288d1f5

File tree

1 file changed

+2
-0
lines changed

1 file changed

+2
-0
lines changed

system-variables.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1538,6 +1538,7 @@ mysql> SELECT job_info FROM mysql.analyze_jobs ORDER BY end_time DESC LIMIT 1;
15381538
- 当设置 `tidb_ddl_enable_fast_reorg``OFF` 时,`ADD INDEX` 会通过事务的方式执行,执行时如果 `ADD INDEX` 的目标列有较多 `UPDATE` 或者 `REPLACE` 等更新操作,batch size 设置的值越大,事务冲突的概率也会越大。此时建议调小 batch size 的值,最小值是 32
15391539
- 在没有事务冲突的情况下,或者当 `tidb_ddl_enable_fast_reorg``ON` 时,batch size 可设为较大值,这样回填数据的速度更快,但是 TiKV 的写入压力也会变大。设置 batch size 时需要参考 `tidb_ddl_reorg_worker_cnt` 的设置值,详情见[线上负载与 `ADD INDEX` 相互影响测试](/benchmark/online-workloads-and-add-index-operations.md)。
15401540
-v8.3.0 版本开始,该参数支持 SESSION 级别的设置,因此修改 GLOBAL 级别的参数值不会影响当前正在运行的 DDL,而只会对新建 SESSION 中提交的 DDL 生效。
1541+
-v8.5.0 版本开始,该参数可以通过 `ADMIN ALTER DDL JOBS <job_id> BATCH_SIZE = <new_batch_size>;` 来修改。不支持修改开启了 [`tidb_enable_dist_task`](/system-variables.md#tidb_enable_dist_task-从-v710-版本开始引入) 的 `ADD INDEX` DDL。更多详情,请见 [`ADMIN ALTER DDL JOBS`](/sql-statements/sql-statement-admin-alter-ddl.md)。
15411542

15421543
### `tidb_ddl_reorg_priority`
15431544

@@ -1580,6 +1581,7 @@ mysql> SELECT job_info FROM mysql.analyze_jobs ORDER BY end_time DESC LIMIT 1;
15801581
- 单位:线程
15811582
- 这个变量用来设置 DDL 操作 `re-organize` 阶段的并发度。
15821583
-v8.3.0 版本开始,该参数支持 SESSION 级别的设置,因此修改 GLOBAL 级别的参数值不会影响当前正在运行的 DDL,而只会对新建 SESSION 中提交的 DDL 生效。
1584+
-v8.5.0 版本开始,该参数可以通过 `ADMIN ALTER DDL JOBS <job_id> BATCH_SIZE = <new_batch_size>;` 来修改。不支持修改开启了 [`tidb_enable_dist_task`](/system-variables.md#tidb_enable_dist_task-从-v710-版本开始引入) 的 `ADD INDEX` DDL。更多详情,请见 [`ADMIN ALTER DDL JOBS`](/sql-statements/sql-statement-admin-alter-ddl.md)。
15831585

15841586
### `tidb_enable_fast_create_table` <span class="version-mark">从 v8.0.0 版本开始引入</span>
15851587

0 commit comments

Comments
 (0)