ADMIN ALTER DDL JOBS
ADMIN ALTER DDL JOBS 语句允许你修改单个正在运行的 DDL 任务的参数。例如：
ADMIN ALTER DDL JOBS 101 THREAD = 8;
101：表示 DDL 任务的 ID。你可以通过执行ADMIN SHOW DDL JOBS获取该 ID。THREAD：表示 DDL 任务的并发度。你可以通过系统变量tidb_ddl_reorg_worker_cnt配置其初始值。
ADMIN ALTER DDL JOBS 语句支持的 DDL 任务类型包括 ADD INDEX、MODIFY COLUMN 和 REORGANIZE PARTITION。对于其他类型的 DDL 任务，执行 ADMIN ALTER DDL JOBS 会返回 unsupported DDL operation 错误。
目前，你只能通过执行 ADMIN ALTER DDL JOBS 修改单个 DDL 任务的参数，不支持同时修改多个 DDL 任务 ID 的参数。
以下是不同 DDL 任务支持的参数及其对应的系统变量：
ADD INDEX：THREAD：DDL 任务的并发度。初始值由tidb_ddl_reorg_worker_cnt设置。BATCH_SIZE：批处理大小。初始值由tidb_ddl_reorg_batch_size设置。MAX_WRITE_SPEED：向每个 TiKV 导入索引记录的最大带宽限制。初始值由tidb_ddl_reorg_max_write_speed设置。
目前，上述参数仅对在禁用
tidb_enable_dist_task后提交并运行的ADD INDEX任务生效。MODIFY COLUMN：THREAD：DDL 任务的并发度。初始值由tidb_ddl_reorg_worker_cnt设置。BATCH_SIZE：批处理大小。初始值由tidb_ddl_reorg_batch_size设置。
REORGANIZE PARTITION：THREAD：DDL 任务的并发度。初始值由tidb_ddl_reorg_worker_cnt设置。BATCH_SIZE：批处理大小。初始值由tidb_ddl_reorg_batch_size设置。
上述参数的取值范围与对应系统变量的取值范围一致。
ADMIN ALTER DDL JOBS 仅对正在运行的 DDL 任务生效。如果 DDL 任务不存在或已完成，执行该语句会返回 ddl job is not running 错误。
以下是该语句的一些示例：
ADMIN ALTER DDL JOBS 101 THREAD = 8;
ADMIN ALTER DDL JOBS 101 BATCH_SIZE = 256;
ADMIN ALTER DDL JOBS 101 MAX_WRITE_SPEED = '200MiB';
ADMIN ALTER DDL JOBS 101 THREAD = 8, BATCH_SIZE = 256;
要查看某个 DDL 任务当前的参数值，你可以执行 ADMIN SHOW DDL JOBS。结果会显示在 COMMENTS 列中：
ADMIN SHOW DDL JOBS 1;
+--------+---------+------------+-----------+--------------+-----------+----------+-----------+----------------------------+----------------------------+----------------------------+--------+-----------------------+
| JOB_ID | DB_NAME | TABLE_NAME | JOB_TYPE | SCHEMA_STATE | SCHEMA_ID | TABLE_ID | ROW_COUNT | CREATE_TIME | START_TIME | END_TIME | STATE | COMMENTS |
+--------+---------+------------+-----------+--------------+-----------+----------+-----------+----------------------------+----------------------------+----------------------------+--------+-----------------------+
| 124 | test | t | add index | public | 2 | 122 | 3 | 2024-11-15 11:17:06.213000 | 2024-11-15 11:17:06.213000 | 2024-11-15 11:17:08.363000 | synced | ingest, DXF, thread=8 |
+--------+---------+------------+-----------+--------------+-----------+----------+-----------+----------------------------+----------------------------+----------------------------+--------+-----------------------+
1 row in set (0.01 sec)
语法
- AdminAlterDDLStmt
- AlterJobOptionList
- AlterJobOption
AdminAlterDDLStmt ::=
'ADMIN' 'ALTER' 'DDL' 'JOBS' Int64Num AlterJobOptionList
AlterJobOptionList ::=
AlterJobOption ( ',' AlterJobOption )*
AlterJobOption ::=
identifier "=" SignedLiteral
MySQL 兼容性
该语句是 TiDB 对 MySQL 语法的扩展。