Skip to content
Merged
Changes from 7 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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