Skip to content

Commit

Permalink
Expand JOB_TYPE documentation for ADMIN SHOW DDL... output (#14461) (#…
Browse files Browse the repository at this point in the history
  • Loading branch information
ti-chi-bot authored Jul 12, 2023
1 parent b3f6a7b commit 36b6afc
Show file tree
Hide file tree
Showing 2 changed files with 8 additions and 1 deletion.
5 changes: 4 additions & 1 deletion sql-statements/sql-statement-admin-show-ddl.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,10 @@ ADMIN SHOW DDL;
- `JOB_ID`:每个 DDL 操作对应一个 DDL 任务,`JOB_ID` 全局唯一。
- `DB_NAME`:执行 DDL 操作的数据库的名称。
- `TABLE_NAME`:执行 DDL 操作的表的名称。
- `JOB_TYPE`:DDL 操作的类型。
- `JOB_TYPE`:DDL 任务的类型。常见的任务类型包括:
- `ingest`:通过 [`tidb_ddl_enable_fast_reorg`](/system-variables.md#tidb_ddl_enable_fast_reorg-从-v630-版本开始引入) 配置的加速索引回填的 ingest 任务。
- `txn`:基本的事务性回填。
- `txn-merge`:在回填完成时将临时索引与原始索引合并的事务性回填。
- `SCHEMA_STATE`:DDL 所操作的 schema 对象的当前状态。如果 `JOB_TYPE``ADD INDEX`,则为索引的状态;如果是 `ADD COLUMN`,则为列的状态;如果是 `CREATE TABLE`,则为表的状态。常见的状态有以下几种:
- `none`:表示不存在。一般 `DROP` 操作或者 `CREATE` 操作失败回滚后,会变为 `none` 状态。
- `delete only``write only``delete reorganization``write reorganization`:这四种状态是中间状态,具体含义请参考 [TiDB 中在线 DDL 异步变更的原理](/ddl-introduction.md#tidb-在线-ddl-异步变更的原理)。由于中间状态转换很快,一般操作中看不到这几种状态,只有执行 `ADD INDEX` 操作时能看到处于 `write reorganization` 状态,表示正在添加索引数据。
Expand Down
4 changes: 4 additions & 0 deletions system-variables.md
Original file line number Diff line number Diff line change
Expand Up @@ -962,6 +962,10 @@ MPP 是 TiFlash 引擎提供的分布式计算框架,允许节点之间的数
> - 如果先启动添加索引加速任务,再尝试启动 PITR 备份任务,此时 PITR 备份任务会抛出错误并退出,但这不会影响正在添加索引的任务。在索引加速任务完成后,你需要重新启动 PITR 日志备份任务,并手动执行一次全量备份。
> - 如果同时启动 PITR 备份任务和添加索引加速任务,可能会由于两个任务无法察觉到对方而导致 PITR 不能成功备份新增的索引数据。在添加索引任务完成后,你仍需要重新启动 PITR 日志备份任务,并手动执行一次全量备份。
> **注意:**
>
> 要使用索引加速功能,你需要提供一个可写且具有足够空余空间的临时路径 [`temp-dir`](/tidb-configuration-file.md#temp-dir-从-v630-版本开始引入)。如果 `temp-dir` 无法使用,TiDB 会退回到非加速的索引创建方式。建议将 `temp-dir` 挂载在 SSD 磁盘上。
### `tidb_ddl_error_count_limit`
- 作用域:GLOBAL
Expand Down

0 comments on commit 36b6afc

Please sign in to comment.