From 7385709671e460567de60fb93cd72703ba6efe74 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Mon, 10 Jul 2023 16:24:07 +0800 Subject: [PATCH 1/6] Add temp.md --- temp.md | 1 + 1 file changed, 1 insertion(+) create mode 100644 temp.md diff --git a/temp.md b/temp.md new file mode 100644 index 000000000000..af27ff4986a7 --- /dev/null +++ b/temp.md @@ -0,0 +1 @@ +This is a test file. \ No newline at end of file From 0a16594074c95aff4d3393e7f111474e515c1463 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Mon, 10 Jul 2023 16:24:14 +0800 Subject: [PATCH 2/6] Delete temp.md --- temp.md | 1 - 1 file changed, 1 deletion(-) delete mode 100644 temp.md diff --git a/temp.md b/temp.md deleted file mode 100644 index af27ff4986a7..000000000000 --- a/temp.md +++ /dev/null @@ -1 +0,0 @@ -This is a test file. \ No newline at end of file From 802c201b1e7670745f9e1ffd02f7996339c18441 Mon Sep 17 00:00:00 2001 From: qiancai Date: Mon, 10 Jul 2023 17:07:36 +0800 Subject: [PATCH 3/6] add translation --- sql-statements/sql-statement-admin-show-ddl.md | 5 ++++- system-variables.md | 4 +++- 2 files changed, 7 insertions(+), 2 deletions(-) diff --git a/sql-statements/sql-statement-admin-show-ddl.md b/sql-statements/sql-statement-admin-show-ddl.md index 0931ee8f6a9e..d6759072539f 100644 --- a/sql-statements/sql-statement-admin-show-ddl.md +++ b/sql-statements/sql-statement-admin-show-ddl.md @@ -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` 状态，表示正在添加索引数据。 diff --git a/system-variables.md b/system-variables.md index d58f3c7cf051..9baada78ff1c 100644 --- a/system-variables.md +++ b/system-variables.md @@ -1243,7 +1243,9 @@ mysql> SELECT job_info FROM mysql.analyze_jobs ORDER BY end_time DESC LIMIT 1; > **注意：** > -> 在升级到 v6.5.0 及以上版本时，建议你检查 TiDB 的 [`temp-dir`](/tidb-configuration-file.md#temp-dir-从-v630-版本开始引入) 路径是否正确挂载了 SSD 磁盘。该参数是 TiDB 的配置参数，设置后需要重启 TiDB 才能生效。因此，在升级前提前进行设置，可以避免再次重启。 +> * 索引加速功能需要一个可写且具有足够空余空间的临时路径 [`temp-dir`](/tidb-configuration-file.md#temp-dir-new-in-v630)。如果 `temp-dir` 无法使用，TiDB 会回退到非加速的索引创建方式。建议将 `temp-dir` 挂载在 SSD 磁盘上。 +> +> * 在升级到 v6.5.0 及以上版本时，建议你检查 TiDB 的 [`temp-dir`](/tidb-configuration-file.md#temp-dir-从-v630-版本开始引入) 路径是否正确挂载了 SSD 磁盘。该参数是 TiDB 的配置参数，设置后需要重启 TiDB 才能生效。因此，在升级前提前进行设置，可以避免再次重启。 ### `tidb_enable_dist_task` 从 v7.1.0 版本开始引入 From ef70aaf753907b11d68d7c6eeec6879729916549 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Mon, 10 Jul 2023 17:10:24 +0800 Subject: [PATCH 4/6] Update sql-statements/sql-statement-admin-show-ddl.md --- sql-statements/sql-statement-admin-show-ddl.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sql-statements/sql-statement-admin-show-ddl.md b/sql-statements/sql-statement-admin-show-ddl.md index d6759072539f..33efe685f079 100644 --- a/sql-statements/sql-statement-admin-show-ddl.md +++ b/sql-statements/sql-statement-admin-show-ddl.md @@ -50,7 +50,7 @@ ADMIN SHOW DDL; - `DB_NAME`：执行 DDL 操作的数据库的名称。 - `TABLE_NAME`：执行 DDL 操作的表的名称。 - `JOB_TYPE`：DDL 任务的类型。常见的任务类型包括： - - `ingest`：通过 [`tidb_ddl_enable_fast_reorg`](/system-variables.md#tidb_ddl_enable_fast_reorg-从-v630-引入) 配置的加速索引回填的 ingest 任务。 + - `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`，则为表的状态。常见的状态有以下几种： From 46bea16288ad467b90e142fb02f0f44697b73f4c Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Tue, 11 Jul 2023 16:33:42 +0800 Subject: [PATCH 5/6] Apply suggestions from code review Co-authored-by: Ran --- system-variables.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/system-variables.md b/system-variables.md index 9baada78ff1c..6743159d3b75 100644 --- a/system-variables.md +++ b/system-variables.md @@ -1243,9 +1243,9 @@ mysql> SELECT job_info FROM mysql.analyze_jobs ORDER BY end_time DESC LIMIT 1; > **注意：** > -> * 索引加速功能需要一个可写且具有足够空余空间的临时路径 [`temp-dir`](/tidb-configuration-file.md#temp-dir-new-in-v630)。如果 `temp-dir` 无法使用，TiDB 会回退到非加速的索引创建方式。建议将 `temp-dir` 挂载在 SSD 磁盘上。 +> * 要使用索引加速功能，你需要提供一个可写且具有足够空余空间的临时路径 [`temp-dir`](/tidb-configuration-file.md#temp-dir-new-in-v630)。如果 `temp-dir` 无法使用，TiDB 会退回到非加速的索引创建方式。建议将 `temp-dir` 挂载在 SSD 磁盘上。 > -> * 在升级到 v6.5.0 及以上版本时，建议你检查 TiDB 的 [`temp-dir`](/tidb-configuration-file.md#temp-dir-从-v630-版本开始引入) 路径是否正确挂载了 SSD 磁盘。该参数是 TiDB 的配置参数，设置后需要重启 TiDB 才能生效。因此，在升级前提前进行设置，可以避免再次重启。 +> * 在升级到 v6.5.0 及以上版本时，请确保 TiDB 的 [`temp-dir`](/tidb-configuration-file.md#temp-dir-从-v630-版本开始引入) 路径已正确挂载了 SSD 磁盘。该参数是 TiDB 的配置参数，设置后需要重启 TiDB 才能生效。因此，在升级前提前进行设置，可以避免再次重启。 ### `tidb_enable_dist_task` 从 v7.1.0 版本开始引入 From b9db80220685d12d2a7b819b06753637cd0c4142 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Wed, 12 Jul 2023 13:30:54 +0800 Subject: [PATCH 6/6] fix a broken link --- system-variables.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/system-variables.md b/system-variables.md index 6743159d3b75..d7a3ecf13808 100644 --- a/system-variables.md +++ b/system-variables.md @@ -1243,7 +1243,7 @@ mysql> SELECT job_info FROM mysql.analyze_jobs ORDER BY end_time DESC LIMIT 1; > **注意：** > -> * 要使用索引加速功能，你需要提供一个可写且具有足够空余空间的临时路径 [`temp-dir`](/tidb-configuration-file.md#temp-dir-new-in-v630)。如果 `temp-dir` 无法使用，TiDB 会退回到非加速的索引创建方式。建议将 `temp-dir` 挂载在 SSD 磁盘上。 +> * 要使用索引加速功能，你需要提供一个可写且具有足够空余空间的临时路径 [`temp-dir`](/tidb-configuration-file.md#temp-dir-从-v630-版本开始引入)。如果 `temp-dir` 无法使用，TiDB 会退回到非加速的索引创建方式。建议将 `temp-dir` 挂载在 SSD 磁盘上。 > > * 在升级到 v6.5.0 及以上版本时，请确保 TiDB 的 [`temp-dir`](/tidb-configuration-file.md#temp-dir-从-v630-版本开始引入) 路径已正确挂载了 SSD 磁盘。该参数是 TiDB 的配置参数，设置后需要重启 TiDB 才能生效。因此，在升级前提前进行设置，可以避免再次重启。