From 4445b47b71b2d32ecbb07ab9cc844d93996a4392 Mon Sep 17 00:00:00 2001 From: husharp Date: Wed, 26 Apr 2023 16:36:42 +0800 Subject: [PATCH 1/5] update Signed-off-by: husharp --- sql-statements/sql-statement-change-column.md | 27 ------------------- 1 file changed, 27 deletions(-) diff --git a/sql-statements/sql-statement-change-column.md b/sql-statements/sql-statement-change-column.md index a1950feeb093..742ec076f006 100644 --- a/sql-statements/sql-statement-change-column.md +++ b/sql-statements/sql-statement-change-column.md @@ -56,9 +56,6 @@ ColumnName ::= ```sql CREATE TABLE t1 (id int not null primary key AUTO_INCREMENT, col1 INT); -``` - -``` Query OK, 0 rows affected (0.11 sec) ``` @@ -66,9 +63,6 @@ Query OK, 0 rows affected (0.11 sec) ```sql INSERT INTO t1 (col1) VALUES (1),(2),(3),(4),(5); -``` - -``` Query OK, 5 rows affected (0.02 sec) Records: 5 Duplicates: 0 Warnings: 0 ``` @@ -77,9 +71,6 @@ Records: 5 Duplicates: 0 Warnings: 0 ```sql ALTER TABLE t1 CHANGE col1 col2 INT; -``` - -``` Query OK, 0 rows affected (0.09 sec) ``` @@ -87,9 +78,6 @@ Query OK, 0 rows affected (0.09 sec) ```sql ALTER TABLE t1 CHANGE col2 col3 BIGINT, ALGORITHM=INSTANT; -``` - -``` Query OK, 0 rows affected (0.08 sec) ``` @@ -97,9 +85,6 @@ Query OK, 0 rows affected (0.08 sec) ```sql ALTER TABLE t1 CHANGE col3 col4 BIGINT, CHANGE id id2 INT NOT NULL; -``` - -``` ERROR 1105 (HY000): can't run multi schema change ``` @@ -108,9 +93,6 @@ ERROR 1105 (HY000): can't run multi schema change ```sql CREATE TABLE t (a int primary key); ALTER TABLE t CHANGE COLUMN a a VARCHAR(10); -``` - -``` ERROR 8200 (HY000): Unsupported modify column: column has primary key flag ``` @@ -119,9 +101,6 @@ ERROR 8200 (HY000): Unsupported modify column: column has primary key flag ```sql CREATE TABLE t (c1 INT, c2 INT, c3 INT) partition by range columns(c1) ( partition p0 values less than (10), partition p1 values less than (maxvalue)); ALTER TABLE t CHANGE COLUMN c1 c1 DATETIME; -``` - -``` ERROR 8200 (HY000): Unsupported modify column: table is partition table ``` @@ -130,9 +109,6 @@ ERROR 8200 (HY000): Unsupported modify column: table is partition table ```sql CREATE TABLE t (a INT, b INT as (a+1)); ALTER TABLE t CHANGE COLUMN b b VARCHAR(10); -``` - -``` ERROR 8200 (HY000): Unsupported modify column: column is generated ``` @@ -141,9 +117,6 @@ ERROR 8200 (HY000): Unsupported modify column: column is generated ```sql CREATE TABLE t (a DECIMAL(13, 7)); ALTER TABLE t CHANGE COLUMN a a DATETIME; -``` - -``` ERROR 8200 (HY000): Unsupported modify column: change from original type decimal(13,7) to datetime is currently unsupported yet ``` From 616fba90c70e1791915f89262b8d62c6c90a8be3 Mon Sep 17 00:00:00 2001 From: Aolin Date: Thu, 27 Apr 2023 18:04:19 +0800 Subject: [PATCH 2/5] update the usage examples Signed-off-by: Aolin --- sql-statements/sql-statement-change-column.md | 122 +++++++++++++----- 1 file changed, 89 insertions(+), 33 deletions(-) diff --git a/sql-statements/sql-statement-change-column.md b/sql-statements/sql-statement-change-column.md index 742ec076f006..a9e4e2ad57b6 100644 --- a/sql-statements/sql-statement-change-column.md +++ b/sql-statements/sql-statement-change-column.md @@ -6,11 +6,11 @@ aliases: ['/docs-cn/dev/sql-statements/sql-statement-change-column/','/docs-cn/d # CHANGE COLUMN -`ALTER TABLE.. CHANGE COLUMN` 语句用于在已有表上更改列，包括对列进行重命名，和将数据改为兼容类型。 +`ALTER TABLE .. CHANGE COLUMN` 语句用于在已有表上更改列，包括对列进行重命名，和将数据改为兼容类型。 从 v5.1.0 版本起，TiDB 开始支持 Reorg 数据的类型变更，包括但不限于： -- 从 varchar 转换为 bigint +- 从 varchar 转换为 bigint - decimal 精度修改 - 从 varchar(10) 到 varchar(5) 的长度压缩 @@ -52,81 +52,137 @@ ColumnName ::= ## 示例 -{{< copyable "sql" >}} +创建表 `t1` 并插入数据： ```sql CREATE TABLE t1 (id int not null primary key AUTO_INCREMENT, col1 INT); -Query OK, 0 rows affected (0.11 sec) +INSERT INTO t1 (col1) VALUES (1),(2),(3),(4),(5); +SELECT * FROM t1; ``` -{{< copyable "sql" >}} +表 `t1` 的数据如下： ```sql -INSERT INTO t1 (col1) VALUES (1),(2),(3),(4),(5); -Query OK, 5 rows affected (0.02 sec) -Records: 5 Duplicates: 0 Warnings: 0 ++----+------+ +| id | col1 | ++----+------+ +| 1 | 1 | +| 2 | 2 | +| 3 | 3 | +| 4 | 4 | +| 5 | 5 | ++----+------+ +5 rows in set (0.01 sec) ``` -{{< copyable "sql" >}} +将表 `t1` 的列 `col1` 重命名为 `col2`： ```sql ALTER TABLE t1 CHANGE col1 col2 INT; -Query OK, 0 rows affected (0.09 sec) +SELECT * FROM t1; ``` -{{< copyable "sql" >}} +表 `t1` 的数据如下： ```sql -ALTER TABLE t1 CHANGE col2 col3 BIGINT, ALGORITHM=INSTANT; -Query OK, 0 rows affected (0.08 sec) ++----+------+ +| id | col2 | ++----+------+ +| 1 | 1 | +| 2 | 2 | +| 3 | 3 | +| 4 | 4 | +| 5 | 5 | ++----+------+ +5 rows in set (0.01 sec) ``` -{{< copyable "sql" >}} +将表 `t1` 的列 `col2` 重命名为 `col3`，并将列的类型从 `INT` 改为 `BIGINT`： ```sql -ALTER TABLE t1 CHANGE col3 col4 BIGINT, CHANGE id id2 INT NOT NULL; -ERROR 1105 (HY000): can't run multi schema change +ALTER TABLE t1 CHANGE col2 col3 BIGINT, ALGORITHM=INSTANT; +SELECT * FROM t1; ``` -{{< copyable "sql" >}} +表 `t1` 的数据如下： ```sql -CREATE TABLE t (a int primary key); -ALTER TABLE t CHANGE COLUMN a a VARCHAR(10); -ERROR 8200 (HY000): Unsupported modify column: column has primary key flag ++----+------+ +| id | col3 | ++----+------+ +| 1 | 1 | +| 2 | 2 | +| 3 | 3 | +| 4 | 4 | +| 5 | 5 | ++----+------+ +5 rows in set (0.00 sec) ``` -{{< copyable "sql" >}} +下面语句将表 `t1` 的列 `col3` 重命名为 `col4`，并将主键 `id` 重命名为 `id2`： ```sql -CREATE TABLE t (c1 INT, c2 INT, c3 INT) partition by range columns(c1) ( partition p0 values less than (10), partition p1 values less than (maxvalue)); -ALTER TABLE t CHANGE COLUMN c1 c1 DATETIME; -ERROR 8200 (HY000): Unsupported modify column: table is partition table +ALTER TABLE t1 CHANGE col3 col4 BIGINT, CHANGE id id2 INT NOT NULL; +ERROR 8200 (HY000): Unsupported modify column: can't remove auto_increment without @@tidb_allow_remove_auto_inc enabled ``` -{{< copyable "sql" >}} +由于 `id` 是自增列，所以不能直接将其重命名为 `id2`。需要先开启 `tidb_allow_remove_auto_inc`，然后再执行 `ALTER TABLE` 语句： ```sql -CREATE TABLE t (a INT, b INT as (a+1)); -ALTER TABLE t CHANGE COLUMN b b VARCHAR(10); -ERROR 8200 (HY000): Unsupported modify column: column is generated +SET tidb_allow_remove_auto_inc = ON; +ALTER TABLE t1 CHANGE col3 col4 BIGINT, CHANGE id id2 INT NOT NULL; +SELECT * FROM t1; ``` -{{< copyable "sql" >}} +表 `t1` 的数据如下： -```sql -CREATE TABLE t (a DECIMAL(13, 7)); -ALTER TABLE t CHANGE COLUMN a a DATETIME; -ERROR 8200 (HY000): Unsupported modify column: change from original type decimal(13,7) to datetime is currently unsupported yet +``` ++-----+------+ +| id2 | col4 | ++-----+------+ +| 1 | 1 | +| 2 | 2 | +| 3 | 3 | +| 4 | 4 | +| 5 | 5 | ++-----+------+ +5 rows in set (0.00 sec) ``` ## MySQL 兼容性 * 不支持主键列上 [Reorg-Data](/sql-statements/sql-statement-modify-column.md#reorg-data-change) 类型的变更。 + + ```sql + CREATE TABLE t (a int primary key); + ALTER TABLE t CHANGE COLUMN a a VARCHAR(10); + ERROR 8200 (HY000): Unsupported modify column: this column has primary key flag + ``` + * 不支持分区表上的列类型变更。 + + ```sql + CREATE TABLE t (c1 INT, c2 INT, c3 INT) partition by range columns(c1) ( partition p0 values less than (10), partition p1 values less than (maxvalue)); + ALTER TABLE t CHANGE COLUMN c1 c1 DATETIME; + ERROR 8200 (HY000): Unsupported modify column: table is partition table + ``` + * 不支持生成列上的列类型变更。 + + ```sql + CREATE TABLE t (a INT, b INT as (a+1)); + ALTER TABLE t CHANGE COLUMN b b VARCHAR(10); + ERROR 8200 (HY000): Unsupported modify column: newCol IsGenerated false, oldCol IsGenerated true + ``` + * 不支持部分数据类型（例如，部分时间类型、Bit、Set、Enum、JSON 等）的变更，因为 TiDB 中 `CAST` 函数与 MySQL 的行为存在兼容性问题。 + ```sql + CREATE TABLE t (a DECIMAL(13, 7)); + ALTER TABLE t CHANGE COLUMN a a DATETIME; + ERROR 8200 (HY000): Unsupported modify column: [ddl:8200]Unsupported modify column: change from original type decimal(13,7) to datetime is currently unsupported yet + ``` + ## 另请参阅 * [CREATE TABLE](/sql-statements/sql-statement-create-table.md) From 5f455aa6b7d3718df554beb63bbdb85eb4aa8bcb Mon Sep 17 00:00:00 2001 From: Aolin Date: Thu, 27 Apr 2023 18:42:51 +0800 Subject: [PATCH 3/5] Apply suggestions from code review --- sql-statements/sql-statement-change-column.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sql-statements/sql-statement-change-column.md b/sql-statements/sql-statement-change-column.md index a9e4e2ad57b6..be6f53525376 100644 --- a/sql-statements/sql-statement-change-column.md +++ b/sql-statements/sql-statement-change-column.md @@ -126,7 +126,7 @@ ALTER TABLE t1 CHANGE col3 col4 BIGINT, CHANGE id id2 INT NOT NULL; ERROR 8200 (HY000): Unsupported modify column: can't remove auto_increment without @@tidb_allow_remove_auto_inc enabled ``` -由于 `id` 是自增列，所以不能直接将其重命名为 `id2`。需要先开启 `tidb_allow_remove_auto_inc`，然后再执行 `ALTER TABLE` 语句： +由于 `id` 是自增列，所以不能直接将其重命名为 `id2`。需要先开启 [`tidb_allow_remove_auto_inc`](/system-variables.md#tidb_allow_remove_auto_inc-从-v2118-和-v304-版本开始引入)，然后再执行 `ALTER TABLE` 语句： ```sql SET tidb_allow_remove_auto_inc = ON; From 2dce0952fa9a28e84df8589c872ce64853440175 Mon Sep 17 00:00:00 2001 From: Aolin Date: Tue, 9 May 2023 15:27:08 +0800 Subject: [PATCH 4/5] add cast incompatibility Signed-off-by: Aolin --- .../cast-functions-and-operators.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/functions-and-operators/cast-functions-and-operators.md b/functions-and-operators/cast-functions-and-operators.md index 1f8f4c3a2037..b86b082625bb 100644 --- a/functions-and-operators/cast-functions-and-operators.md +++ b/functions-and-operators/cast-functions-and-operators.md @@ -14,3 +14,13 @@ Cast 函数和操作符用于将某种数据类型的值转换为另一种数据 | [`BINARY`](https://dev.mysql.com/doc/refman/5.7/en/cast-functions.html#operator_binary) | 将一个字符串转换成一个二进制字符串 | | [`CAST()`](https://dev.mysql.com/doc/refman/5.7/en/cast-functions.html#function_cast) | 将一个值转换成一个确定类型 | | [`CONVERT()`](https://dev.mysql.com/doc/refman/5.7/en/cast-functions.html#function_convert) | 将一个值转换成一个确定类型 | + +## MySQL 兼容性 + +TiDB 不支持部分数据类型的变更，例如部分时间类型、Bit、Set、Enum 和 JSON 等。 + +```sql +CREATE TABLE t (a DECIMAL(13, 7)); +ALTER TABLE t CHANGE COLUMN a a DATETIME; +ERROR 8200 (HY000): Unsupported modify column: [ddl:8200]Unsupported modify column: change from original type decimal(13,7) to datetime is currently unsupported yet +``` From 54e13b92b6489490d45f8f35338fd93c8a095467 Mon Sep 17 00:00:00 2001 From: husharp Date: Wed, 31 May 2023 20:54:56 +0800 Subject: [PATCH 5/5] update Signed-off-by: husharp --- functions-and-operators/cast-functions-and-operators.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/functions-and-operators/cast-functions-and-operators.md b/functions-and-operators/cast-functions-and-operators.md index ba57b417b31d..cc8c9cd4d316 100644 --- a/functions-and-operators/cast-functions-and-operators.md +++ b/functions-and-operators/cast-functions-and-operators.md @@ -17,7 +17,7 @@ Cast 函数和操作符用于将某种数据类型的值转换为另一种数据 > **注意：** > -> TiDB 和 MySQL 对于 `SELECT CAST(MeN AS CHAR)`（或者等价的 `SELECT CONVERT(MeM, CHAR)`）的结果显示不一致，其中 `MeN` 是用科学计数法表示的双精度浮点数。MySQL 在 `-15 <= N <= 14` 时显示完整数值，在 `N < -15` 或 `N > 14` 时显示科学计数法。而 TiDB 始终显示完整数值。例如，MySQL 对于 `SELECT CAST(3.1415e15 AS CHAR)` 的显示结果为 `3.1415e15`，而 TiDB 的显示结果为 `3141500000000000` +> TiDB 和 MySQL 对于 `SELECT CAST(MeN AS CHAR)`（或者等价的 `SELECT CONVERT(MeM, CHAR)`）的结果显示不一致，其中 `MeN` 是用科学计数法表示的双精度浮点数。MySQL 在 `-15 <= N <= 14` 时显示完整数值，在 `N < -15` 或 `N > 14` 时显示科学计数法。而 TiDB 始终显示完整数值。例如，MySQL 对于 `SELECT CAST(3.1415e15 AS CHAR)` 的显示结果为 `3.1415e15`，而 TiDB 的显示结果为 `3141500000000000`。 ## MySQL 兼容性