Skip to content
Open
15 changes: 13 additions & 2 deletions sql-statements/sql-statement-modify-column.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,12 +8,23 @@ aliases: ['/docs-cn/dev/sql-statements/sql-statement-modify-column/','/docs-cn/d

`ALTER TABLE .. MODIFY COLUMN` 语句用于修改已有表上的列,包括列的数据类型和属性。若要同时重命名,可改用 [`CHANGE COLUMN`](/sql-statements/sql-statement-change-column.md) 语句。

从 v5.1.0 版本起,TiDB 开始支持 Reorg 类型变更,包括但不限于:
从 v5.1.0 版本起,TiDB 开始支持 Reorg-Data 类型变更,包括但不限于:

- 从 `VARCHAR` 转换为 `BIGINT`
- `DECIMAL` 精度修改
- 从 `VARCHAR(10)` 到 `VARCHAR(5)` 的长度压缩

Reorg-Data 指的是在修改列类型时,TiDB 需要对表中的现有数据进行重建,包括读取原数据,按照新的数据格式进行处理,然后重新写入表中。这类操作通常比较耗时,时间消耗与表中的数据量成正比。

从 v8.5.5 和 v9.0.0 版本起,TiDB 优化了部分 Reorg-Data 类型变更的执行效率。在 [SQL 模式](/sql-mode.md)严格模式(即 `sql_mode` 值包含 `STRICT_TRANS_TABLES` 或 `STRICT_ALL_TABLES`),在进行以下类型变更时,TiDB 将不再进行表数据重建,只进行部分索引的重建:

- 整数类型之间的变更(例如 `BIGINT` 到 `INT`)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

这个场景下,是不是不需要重建索引?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

不需要。之前需要

- 字符串类型之间的变更(例如 `VARCHAR(200)` 到 `VARCHAR(100)`)

> **注意:**
>
> 当 `VARCHAR` 转换为 `CHAR` 时,要求所有原数据的末尾均不包含空格;若不满足该条件,TiDB 仍会执行 Reorg-Data。

## 语法图

```ebnf+diagram
Expand Down Expand Up @@ -168,7 +179,7 @@ CREATE TABLE `t1` (
> ERROR 1406 (22001): Data Too Long, field len 4, data len 5
> ```
>
> - 由于和 Async Commit 功能兼容,DDL 在开始进入到 Reorg Data 前会有一定时间(约 2.5s)的等待处理:
> - 由于和 Async Commit 功能兼容,在关闭[元数据锁](/metadata-lock.md)的情况下,DDL 在开始进入到 Reorg Data 前会有一定时间(约 2.5s)的等待处理:
>
> ```
> Query OK, 0 rows affected (2.52 sec)
Expand Down