From 33e6dc722c6befd85b4c3d9e0c68e20e00f44211 Mon Sep 17 00:00:00 2001 From: tangenta Date: Wed, 22 Jun 2022 11:10:32 +0800 Subject: [PATCH 1/3] add description for @@tidb_enable_change_multi_schema --- system-variables.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/system-variables.md b/system-variables.md index 8136a6035f98..ef99b3ef1762 100644 --- a/system-variables.md +++ b/system-variables.md @@ -676,6 +676,20 @@ MPP 是 TiFlash 引擎提供的分布式计算框架，允许节点之间的数 - 默认值：`OFF` - 这个变量用于控制是否允许在创建生成列或者表达式索引时引用自增列。 +### `tidb_enable_change_multi_schema` + +- 作用域：GLOBAL +- 是否持久化到集群：是 +- 默认值：`OFF` +- 这个变量用于控制是否允许在一个 ALTER TABLE 语句中变更多个列或者索引。在该变量为 `ON` 的情况下，目前仅支持以下的多模式对象变更： + - 添加多列，例如 `ATLER TABLE t ADD COLUMN c1 INT, ADD COLUMN c2 INT;`。 + - 删除多列，例如 `ATLER TABLE t DROP COLUMN c1, DROP COLUMN c2;`。 + - 删除多个索引，例如 `ATLER TABLE t DROP INDEX i1, DROP INDEX i2;`。 + +> **注意：** +> +> TiDB 未来会支持更多种类的多模式对象变更，该系统变量将在后续版本中移除。 + ### `tidb_enable_cascades_planner` > **警告：** From 82c61e5ba03924681e73080c3a92008cb94b7f66 Mon Sep 17 00:00:00 2001 From: tangenta Date: Wed, 22 Jun 2022 11:21:53 +0800 Subject: [PATCH 2/3] add more supported multi-schema change --- system-variables.md | 1 + 1 file changed, 1 insertion(+) diff --git a/system-variables.md b/system-variables.md index ef99b3ef1762..10ca0ad2e0e5 100644 --- a/system-variables.md +++ b/system-variables.md @@ -685,6 +685,7 @@ MPP 是 TiFlash 引擎提供的分布式计算框架，允许节点之间的数 - 添加多列，例如 `ATLER TABLE t ADD COLUMN c1 INT, ADD COLUMN c2 INT;`。 - 删除多列，例如 `ATLER TABLE t DROP COLUMN c1, DROP COLUMN c2;`。 - 删除多个索引，例如 `ATLER TABLE t DROP INDEX i1, DROP INDEX i2;`。 + - 删除被单列索引所覆盖的列，例如 `ALTER TABLE t DROP COLUMN c1`, 表结构中包含 `INDEX idx(c1)`。 > **注意：** > From 070b8da683f9ea0794307d5fa5bd5283266a3d57 Mon Sep 17 00:00:00 2001 From: TomShawn <41534398+TomShawn@users.noreply.github.com> Date: Wed, 22 Jun 2022 11:42:22 +0800 Subject: [PATCH 3/3] move warning note --- system-variables.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/system-variables.md b/system-variables.md index 10ca0ad2e0e5..b9ac3ee8914f 100644 --- a/system-variables.md +++ b/system-variables.md @@ -678,19 +678,19 @@ MPP 是 TiFlash 引擎提供的分布式计算框架，允许节点之间的数 ### `tidb_enable_change_multi_schema` +> **警告：** +> +> TiDB 未来会支持更多种类的多模式对象变更，该系统变量将在后续版本中移除。 + - 作用域：GLOBAL - 是否持久化到集群：是 - 默认值：`OFF` -- 这个变量用于控制是否允许在一个 ALTER TABLE 语句中变更多个列或者索引。在该变量为 `ON` 的情况下，目前仅支持以下的多模式对象变更： +- 这个变量用于控制是否允许在一个 `ALTER TABLE` 语句中变更多个列或者索引。该变量值为 `ON` 时，仅支持以下多模式对象变更： - 添加多列，例如 `ATLER TABLE t ADD COLUMN c1 INT, ADD COLUMN c2 INT;`。 - 删除多列，例如 `ATLER TABLE t DROP COLUMN c1, DROP COLUMN c2;`。 - 删除多个索引，例如 `ATLER TABLE t DROP INDEX i1, DROP INDEX i2;`。 - 删除被单列索引所覆盖的列，例如 `ALTER TABLE t DROP COLUMN c1`, 表结构中包含 `INDEX idx(c1)`。 -> **注意：** -> -> TiDB 未来会支持更多种类的多模式对象变更，该系统变量将在后续版本中移除。 - ### `tidb_enable_cascades_planner` > **警告：**