diff --git a/sql-statements/sql-statement-admin-alter-ddl.md b/sql-statements/sql-statement-admin-alter-ddl.md index 366abeaaed52..7f585146d6dd 100644 --- a/sql-statements/sql-statement-admin-alter-ddl.md +++ b/sql-statements/sql-statement-admin-alter-ddl.md @@ -27,8 +27,6 @@ ADMIN ALTER DDL JOBS 101 THREAD = 8; - `BATCH_SIZE`:批大小,初始值由系统变量 [`tidb_ddl_reorg_batch_size`](/system-variables.md#tidb_ddl_reorg_batch_size) 设置。 - `MAX_WRITE_SPEED`:向每个 TiKV 导入索引记录时的最大带宽限制,初始值由系统变量 [`tidb_ddl_reorg_max_write_speed`](/system-variables.md#tidb_ddl_reorg_max_write_speed-从-v6512v755-和-v850-版本开始引入) 设置。 - 以上设置,当前仅对关闭 [`tidb_enable_dist_task`](/system-variables.md#tidb_enable_dist_task-从-v710-版本开始引入) 后,提交并运行中的 `ADD INDEX` 的作业生效。 - - `MODIFY COLUMN`: - `THREAD`:并发度,初始值由系统变量 `tidb_ddl_reorg_worker_cnt` 设置。 - `BATCH_SIZE`:批大小,初始值由系统变量 `tidb_ddl_reorg_batch_size` 设置。 diff --git a/system-variables.md b/system-variables.md index 267b88c4e84b..2d120fb3e4c3 100644 --- a/system-variables.md +++ b/system-variables.md @@ -1557,7 +1557,7 @@ mysql> SELECT job_info FROM mysql.analyze_jobs ORDER BY end_time DESC LIMIT 1; - 当设置 `tidb_ddl_enable_fast_reorg` 为 `OFF` 时,`ADD INDEX` 会通过事务的方式执行,执行时如果 `ADD INDEX` 的目标列有较多 `UPDATE` 或者 `REPLACE` 等更新操作,batch size 设置的值越大,事务冲突的概率也会越大。此时建议调小 batch size 的值,最小值是 32。 - 在没有事务冲突的情况下,或者当 `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)。 - 从 v8.3.0 版本开始,该参数支持 SESSION 级别的设置,因此修改 GLOBAL 级别的参数值不会影响当前正在运行的 DDL,而只会对新建 SESSION 中提交的 DDL 生效。 - - 从 v8.5.0 版本开始,该参数可以通过 `ADMIN ALTER DDL JOBS 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)。 + - 从 v8.5.0 版本开始,该参数可以通过 `ADMIN ALTER DDL JOBS BATCH_SIZE = ;` 来修改。 ### `tidb_ddl_reorg_priority` @@ -1600,7 +1600,7 @@ mysql> SELECT job_info FROM mysql.analyze_jobs ORDER BY end_time DESC LIMIT 1; - 单位:线程 - 这个变量用来设置 DDL 操作 `re-organize` 阶段的并发度。 - 从 v8.3.0 版本开始,该参数支持 SESSION 级别的设置,因此修改 GLOBAL 级别的参数值不会影响当前正在运行的 DDL,而只会对新建 SESSION 中提交的 DDL 生效。 -- 从 v8.5.0 版本开始,该参数可以通过 `ADMIN ALTER DDL JOBS 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)。 +- 从 v8.5.0 版本开始,该参数可以通过 `ADMIN ALTER DDL JOBS BATCH_SIZE = ;` 来修改。 ### `tidb_enable_fast_create_table` 从 v8.0.0 版本开始引入