From 6429e4cb881176b72328d6c8464c9468fa3559d0 Mon Sep 17 00:00:00 2001 From: D3Hunter Date: Mon, 11 Nov 2024 10:30:10 +0800 Subject: [PATCH 1/5] change --- accelerated-table-creation.md | 8 +++----- system-variables.md | 7 ++----- 2 files changed, 5 insertions(+), 10 deletions(-) diff --git a/accelerated-table-creation.md b/accelerated-table-creation.md index 71e22d7233e5..b1e1ebf3539c 100644 --- a/accelerated-table-creation.md +++ b/accelerated-table-creation.md @@ -12,13 +12,9 @@ TiDB v7.6.0 引入了系统变量 [`tidb_ddl_version`](https://docs.pingcap.com/ 合并后的批量建表语句在同一个事务内执行，如果其中一个语句失败，所有语句都会失败。 -> **警告：** -> -> TiDB 加速建表目前为实验特性，不建议在生产环境中使用。该功能可能会在未事先通知的情况下发生变化或删除。如果发现 bug，请在 GitHub 上提 [issue](https://github.com/pingcap/tidb/issues) 反馈。 - ## 与 TiDB 工具的兼容性 -- [TiCDC](/ticdc/ticdc-overview.md) 暂不支持同步通过 TiDB 加速创建的表。 +- TiDB v8.3.0 版本之前 [TiCDC](/ticdc/ticdc-overview.md) 暂不支持同步通过 TiDB 加速创建的表。TiDB v8.3.0 版本之后可以正常同步。 ## 限制 @@ -28,6 +24,8 @@ TiDB 加速建表目前仅适用于 [`CREATE TABLE`](/sql-statements/sql-stateme 你可以通过设置系统变量 [`tidb_enable_fast_create_table`](/system-variables.md#tidb_enable_fast_create_table-从-v800-版本开始引入) 的值来开启或关闭加速建表的功能。 +从 TiDB v8.5.0 版本开始，新建集群 `tidb_enable_fast_create_table` 默认开启，如果是从老版本升级上来，`tidb_enable_fast_create_table` 维持原值。 + 要开启该功能，将该变量的值设置为 `ON`： ```sql diff --git a/system-variables.md b/system-variables.md index 847a21f1ac90..47a909a9fbc0 100644 --- a/system-variables.md +++ b/system-variables.md @@ -1530,18 +1530,15 @@ mysql> SELECT job_info FROM mysql.analyze_jobs ORDER BY end_time DESC LIMIT 1; ### `tidb_enable_fast_create_table` 从 v8.0.0 版本开始引入 -> **警告：** -> -> 该变量目前为实验特性，不建议在生产环境中使用。该功能可能会在未事先通知的情况下发生变化或删除。如果发现 bug，请在 GitHub 上提 [issue](https://github.com/pingcap/tidb/issues) 反馈。 - - 作用域：GLOBAL - 是否持久化到集群：是 - 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 - 类型：布尔型 -- 默认值：`OFF` +- 默认值：`ON` - 这个变量用于控制是否开启 [TiDB 加速建表](/accelerated-table-creation.md)。 - 从 TiDB v8.0.0 开始，支持使用 `tidb_enable_fast_create_table` 加速建表 [`CREATE TABLE`](/sql-statements/sql-statement-create-table.md)。 - 该变量是由 v7.6.0 中引入的 [`tidb_ddl_version`](https://docs.pingcap.com/zh/tidb/v7.6/system-variables#tidb_ddl_version-从-v760-版本开始引入) 更名而来。从 v8.0.0 开始，`tidb_ddl_version` 不再生效。 +- 从 TiDB v8.5.0 版本开始，新建集群 `tidb_enable_fast_create_table` 默认开启，如果是从老版本升级上来，`tidb_enable_fast_create_table` 维持原值。 ### `tidb_default_string_match_selectivity` 从 v6.2.0 版本开始引入 From d60bc31a6f8b156de19fb955dbc5917643a3aa5f Mon Sep 17 00:00:00 2001 From: D3Hunter Date: Wed, 13 Nov 2024 19:17:28 +0800 Subject: [PATCH 2/5] Update system-variables.md Co-authored-by: Aolin --- system-variables.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/system-variables.md b/system-variables.md index 47a909a9fbc0..978a57a15c20 100644 --- a/system-variables.md +++ b/system-variables.md @@ -1534,7 +1534,7 @@ mysql> SELECT job_info FROM mysql.analyze_jobs ORDER BY end_time DESC LIMIT 1; - 是否持久化到集群：是 - 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 - 类型：布尔型 -- 默认值：`ON` +- 默认值：`ON`。在 v8.5.0 之前，默认值为 `OFF`。 - 这个变量用于控制是否开启 [TiDB 加速建表](/accelerated-table-creation.md)。 - 从 TiDB v8.0.0 开始，支持使用 `tidb_enable_fast_create_table` 加速建表 [`CREATE TABLE`](/sql-statements/sql-statement-create-table.md)。 - 该变量是由 v7.6.0 中引入的 [`tidb_ddl_version`](https://docs.pingcap.com/zh/tidb/v7.6/system-variables#tidb_ddl_version-从-v760-版本开始引入) 更名而来。从 v8.0.0 开始，`tidb_ddl_version` 不再生效。 From 6001a421a89b5241f80411b0dd1a6c20a4856bfa Mon Sep 17 00:00:00 2001 From: D3Hunter Date: Wed, 13 Nov 2024 19:17:48 +0800 Subject: [PATCH 3/5] Update system-variables.md Co-authored-by: Aolin --- system-variables.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/system-variables.md b/system-variables.md index 978a57a15c20..7909e31612b3 100644 --- a/system-variables.md +++ b/system-variables.md @@ -1538,7 +1538,7 @@ mysql> SELECT job_info FROM mysql.analyze_jobs ORDER BY end_time DESC LIMIT 1; - 这个变量用于控制是否开启 [TiDB 加速建表](/accelerated-table-creation.md)。 - 从 TiDB v8.0.0 开始，支持使用 `tidb_enable_fast_create_table` 加速建表 [`CREATE TABLE`](/sql-statements/sql-statement-create-table.md)。 - 该变量是由 v7.6.0 中引入的 [`tidb_ddl_version`](https://docs.pingcap.com/zh/tidb/v7.6/system-variables#tidb_ddl_version-从-v760-版本开始引入) 更名而来。从 v8.0.0 开始，`tidb_ddl_version` 不再生效。 -- 从 TiDB v8.5.0 版本开始，新建集群 `tidb_enable_fast_create_table` 默认开启，如果是从老版本升级上来，`tidb_enable_fast_create_table` 维持原值。 +- 从 TiDB v8.5.0 开始，新创建的集群默认开启 TiDB 加速建表功能，即 `tidb_enable_fast_create_table` 默认值为 `ON`。如果从 v8.4.0 及之前版本的集群升级至 v8.5.0 及之后的版本，`tidb_enable_fast_create_table` 的默认值不发生变化。 ### `tidb_default_string_match_selectivity` 从 v6.2.0 版本开始引入 From 928be41c20e56c115182ead4a042802b10231192 Mon Sep 17 00:00:00 2001 From: D3Hunter Date: Wed, 13 Nov 2024 19:17:56 +0800 Subject: [PATCH 4/5] Update accelerated-table-creation.md Co-authored-by: Aolin --- accelerated-table-creation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/accelerated-table-creation.md b/accelerated-table-creation.md index b1e1ebf3539c..c3af747d7d50 100644 --- a/accelerated-table-creation.md +++ b/accelerated-table-creation.md @@ -24,7 +24,7 @@ TiDB 加速建表目前仅适用于 [`CREATE TABLE`](/sql-statements/sql-stateme 你可以通过设置系统变量 [`tidb_enable_fast_create_table`](/system-variables.md#tidb_enable_fast_create_table-从-v800-版本开始引入) 的值来开启或关闭加速建表的功能。 -从 TiDB v8.5.0 版本开始，新建集群 `tidb_enable_fast_create_table` 默认开启，如果是从老版本升级上来，`tidb_enable_fast_create_table` 维持原值。 +从 TiDB v8.5.0 开始，新创建的集群默认开启 TiDB 加速建表功能，即 `tidb_enable_fast_create_table` 默认值为 `ON`。如果从 v8.4.0 及之前版本的集群升级至 v8.5.0 及之后的版本，`tidb_enable_fast_create_table` 的默认值不发生变化。 要开启该功能，将该变量的值设置为 `ON`： From 60c4bbf3ae5e5ca556cc40b4971312b5fdd13e3d Mon Sep 17 00:00:00 2001 From: Aolin Date: Tue, 19 Nov 2024 10:44:19 +0800 Subject: [PATCH 5/5] refine wording --- accelerated-table-creation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/accelerated-table-creation.md b/accelerated-table-creation.md index c3af747d7d50..72148de25ac0 100644 --- a/accelerated-table-creation.md +++ b/accelerated-table-creation.md @@ -14,7 +14,7 @@ TiDB v7.6.0 引入了系统变量 [`tidb_ddl_version`](https://docs.pingcap.com/ ## 与 TiDB 工具的兼容性 -- TiDB v8.3.0 版本之前 [TiCDC](/ticdc/ticdc-overview.md) 暂不支持同步通过 TiDB 加速创建的表。TiDB v8.3.0 版本之后可以正常同步。 +- 在 TiDB v8.3.0 之前的版本中，[TiCDC](/ticdc/ticdc-overview.md) 不支持同步通过 TiDB 加速创建的表。从 v8.3.0 开始，TiCDC 可以正常同步这类表。 ## 限制