ALTER [ONLINE | OFFLINE] [IGNORE] TABLE tbl_name
    [alter_option [, alter_option] ...]
    [partition_options]

alter_option: {
    table_options
  | ADD [COLUMN] col_name column_definition
        [FIRST | AFTER col_name]
  | ADD [COLUMN] (col_name column_definition,...)
  | ADD {INDEX | KEY} [index_name]
        [index_type] (key_part,...) [index_option] ...
  | ADD {FULLTEXT | SPATIAL} [INDEX | KEY] [index_name]
        (key_part,...) [index_option] ...
  | ADD [CONSTRAINT [symbol]] PRIMARY KEY
        [index_type] (key_part,...)
        [index_option] ...
  | ADD [CONSTRAINT [symbol]] UNIQUE [INDEX | KEY]
        [index_name] [index_type] (key_part,...)
        [index_option] ...
  | ADD [CONSTRAINT [symbol]] FOREIGN KEY
        [index_name] (col_name,...)
        reference_definition
  | ADD CHECK (expr)
  | ALGORITHM [=] {DEFAULT | INPLACE | COPY}
  | ALTER [COLUMN] col_name {
        SET DEFAULT {literal | (expr)}
      | DROP DEFAULT
    }
  | CHANGE [COLUMN] old_col_name new_col_name column_definition
        [FIRST | AFTER col_name]
  | [DEFAULT] CHARACTER SET [=] charset_name [COLLATE [=] collation_name]
  | CONVERT TO CHARACTER SET charset_name [COLLATE collation_name]
  | {DISABLE | ENABLE} KEYS
  | {DISCARD | IMPORT} TABLESPACE
  | DROP [COLUMN] col_name
  | DROP {INDEX | KEY} index_name
  | DROP PRIMARY KEY
  | DROP FOREIGN KEY fk_symbol
  | FORCE
  | LOCK [=] {DEFAULT | NONE | SHARED | EXCLUSIVE}
  | MODIFY [COLUMN] col_name column_definition
        [FIRST | AFTER col_name]
  | ORDER BY col_name [, col_name] ...
  | RENAME [TO | AS] new_tbl_name
}

partition_options:
    partition_option [partition_option] ...

partition_option: {
    ADD PARTITION (partition_definition)
  | DROP PARTITION partition_names
  | TRUNCATE PARTITION {partition_names | ALL}
  | COALESCE PARTITION number
  | REORGANIZE PARTITION partition_names INTO (partition_definitions)
  | EXCHANGE PARTITION partition_name WITH TABLE tbl_name
  | ANALYZE PARTITION {partition_names | ALL}
  | CHECK PARTITION {partition_names | ALL}
  | OPTIMIZE PARTITION {partition_names | ALL}
  | REBUILD PARTITION {partition_names | ALL}
  | REPAIR PARTITION {partition_names | ALL}
  | REMOVE PARTITIONING
}

key_part:
    col_name [(length)] [ASC | DESC]

index_type:
    USING {BTREE | HASH}

index_option: {
    KEY_BLOCK_SIZE [=] value
  | index_type
  | WITH PARSER parser_name
  | COMMENT 'string'
}

table_options:
    table_option [[,] table_option] ...

table_option: {
    AUTO_INCREMENT [=] value
  | AVG_ROW_LENGTH [=] value
  | [DEFAULT] CHARACTER SET [=] charset_name
  | CHECKSUM [=] {0 | 1}
  | [DEFAULT] COLLATE [=] collation_name
  | COMMENT [=] 'string'
  | CONNECTION [=] 'connect_string'
  | {DATA | INDEX} DIRECTORY [=] 'absolute path to directory'
  | DELAY_KEY_WRITE [=] {0 | 1}
  | ENGINE [=] engine_name
  | INSERT_METHOD [=] { NO | FIRST | LAST }
  | KEY_BLOCK_SIZE [=] value
  | MAX_ROWS [=] value
  | MIN_ROWS [=] value
  | PACK_KEYS [=] {0 | 1 | DEFAULT}
  | PASSWORD [=] 'string'
  | ROW_FORMAT [=] {DEFAULT | DYNAMIC | FIXED | COMPRESSED | REDUNDANT | COMPACT}
  | STATS_AUTO_RECALC [=] {DEFAULT | 0 | 1}
  | STATS_PERSISTENT [=] {DEFAULT | 0 | 1}
  | STATS_SAMPLE_PAGES [=] value
  | TABLESPACE tablespace_name [STORAGE {DISK | MEMORY}]
  | UNION [=] (tbl_name[,tbl_name]...)
}

ALTER TABLE改变表的结构。例如，您可以添加或删除列、创建或销毁索引、更改现有列的类型或重命名列或表本身。您还可以更改特性，例如用于表或表注释的存储引擎。

该声明还有几个其他方面，ALTER TABLE在本节的以下主题下进行了描述：

表格选项

table_options表示可在CREATE TABLE语句中使用的那种表选项，例如ENGINE、 AUTO_INCREMENT、 AVG_ROW_LENGTH、MAX_ROWS或 ROW_FORMAT。

有关所有表选项的说明，请参阅 第 13.1.17 节，“CREATE TABLE 语句”。但是， ALTER TABLE忽略DATA DIRECTORY和INDEX DIRECTORY作为表选项给出时。ALTER TABLE 只允许它们作为分区选项，并且从 MySQL 5.6.35 开始，需要您有FILE 权限。

使用表选项ALTER TABLE提供了一种更改单个表特征的便捷方法。例如：

要验证表选项是否按预期更改，请使用 SHOW CREATE TABLE或查询 INFORMATION_SCHEMA.TABLES表。

性能和空间要求

ALTER TABLE使用以下算法之一处理操作：

对于使用NDB存储引擎的表，这些算法的工作原理如下：

有关更多信息，请参阅第 18.6.12 节，“在 NDB Cluster 中使用 ALTER TABLE 进行在线操作”。

该ALGORITHM子句是可选的。如果该 ALGORITHM子句被省略（或者如果您指定 ALGORITHM=DEFAULT），MySQL 将使用 支持它ALGORITHM=INPLACE的存储引擎和 ALTER TABLE子句。否则，ALGORITHM=COPY使用。

指定一个ALGORITHM子句要求操作对支持它的子句和存储引擎使用指定的算法，否则会失败并出现错误。指定ALGORITHM=DEFAULT与省略ALGORITHM子句相同。

ALTER TABLE使用该 COPY算法的操作等待正在修改表的其他操作完成。对表副本应用更改后，数据被复制过来，原始表被删除，表副本被重命名为原始表的名称。当ALTER TABLE 操作执行时，原始表可被其他会话读取（例外情况稍后会注明）。操作开始后对表的更新和写入将ALTER TABLE停止，直到新表准备就绪，然后自动重定向到新表。表的临时副本在原始表的数据库目录中创建，除非它是RENAME TO 将表移动到驻留在不同目录中的数据库的操作。

前面提到的例外是 在准备安装新版本的表文件、丢弃旧文件以及从表和表定义缓存中清除过时的表结构时ALTER TABLE阻止读取（而不仅仅是写入） 。.frm此时，它必须获得一个独占锁。为此，它等待当前读者完成，并阻止新的读写。

ALTER TABLE使用该算法 的操作COPY可防止并发 DML 操作。仍然允许并发查询。也就是说，一个表复制操作总是至少包括LOCK=SHARED（允许查询但不包括 DML）的并发限制。您可以通过指定 来进一步限制支持该LOCK子句的 操作的并发性LOCK=EXCLUSIVE，这会阻止 DML 和查询。有关详细信息，请参阅 并发控制。

要强制将COPY算法用于 ALTER TABLE原本不会使用它的操作，请启用 old_alter_table系统变量或指定ALGORITHM=COPY. old_alter_table如果设置与ALGORITHM值不是 的子句 之间存在冲突DEFAULT，则该ALGORITHM 子句优先。

对于InnoDB表， 对驻留在共享表空间（例如 系统表空间ALTER TABLE）中的表使用该算法的操作 会增加表空间使用的空间量。此类操作需要与表中的数据加上索引一样多的额外空间。对于驻留在共享表空间中的表，操作期间使用的额外空间不会释放回操作系统，就像驻留在file-per-table 表空间中的表一样 。 COPY

有关在线 DDL 操作的空间要求的信息，请参阅 第 14.13.3 节，“在线 DDL 空间要求”。

ALTER TABLE支持该INPLACE算法的操作包括：

从 MySQL 5.6.16 开始，ALTER TABLE 将 MySQL 5.5 临时列升级到 5.6 格式，用于ADD COLUMN、CHANGE COLUMN、 MODIFY COLUMN、ADD INDEX和FORCE操作。INPLACE由于必须重建表，因此 无法使用该算法完成此转换，因此ALGORITHM=INPLACE在这些情况下指定会导致错误。ALGORITHM=COPY必要时 指定。

NDB Cluster 支持使用MySQL NDB Cluster 7.3 及更高版本中的语法进行在线ALTER TABLE 操作。ALGORITHM=INPLACENDB Cluster 还支持特定于 NDB 的旧语法，该语法使用 ONLINE和OFFLINE关键字。从 MySQL NDB Cluster 7.3 开始不推荐使用这些关键字；它们在 MySQL NDB Cluster 7.4 中继续受到支持，但在未来版本的 NDB Cluster 中可能会被删除。有关确切的语法和其他细节 ，请参阅 第 18.6.12 节，“在 NDB Cluster 中使用 ALTER TABLE 进行在线操作” 。

如果ALTER TABLE对用于对表进行分区的多列索引的操作KEY更改了列的顺序，则只能使用 ALGORITHM=COPY.

ALGORITHM=INPLACEMySQL NDB Cluster 7.3（及更高版本）支持使用与标准 MySQL 服务器 相同的语法进行在线操作。NDB Cluster 7.3 和 7.4 还继续支持使用和关键字的在线ALTER TABLE操作以 实现向后兼容性，但这些关键字在 NDB 7.3 和 7.4 中已弃用，并且从 NDB 7.5 开始不再受支持。 不支持联机更改表空间。有关更多信息，请参阅第 18.6.12 节，“在 NDB Cluster 中使用 ALTER TABLE 进行在线操作”。 ONLINEOFFLINENDB

ALTER TABLEwith ADD PARTITION, DROP PARTITION, COALESCE PARTITION, REBUILD PARTITION, orREORGANIZE PARTITION 不创建临时表（与 NDB表一起使用时除外）；但是，这些操作可以而且确实会创建临时分区文件。

ADDor或partitions 的DROP操作 是立即操作或几乎是立即操作。or 操作 或分区在所有分区之间复制数据，除非使用or ；这实际上与创建新表相同，尽管 or操作是逐个分区执行的。操作仅复制已更改的分区，而不会触及未更改的分区。 RANGELISTADDCOALESCEHASHKEYLINEAR HASHLINEAR KEYADDCOALESCEREORGANIZE

对于表，您可以通过将系统变量设置为较高的值 MyISAM来加快重新创建索引（更改过程中最慢的部分） 。myisam_sort_buffer_size

并发控制

对于ALTER TABLE支持它的操作，您可以使用该LOCK子句来控制表被更改时的并发读写级别。为该子句指定一个非默认值使您能够在更改操作期间要求一定数量的并发访问或排他性，并在请求的锁定程度不可用时停止操作。该LOCK子句的参数是：

添加和删​​除列

用于ADD向表中添加新列，以及 DROP删除现有列。是标准 SQL 的 MySQL 扩展。 DROP col_name

要在表格行内的特定位置添加列，请使用 FIRST或。默认是最后添加列。 AFTER col_name

如果一个表只包含一列，则不能删除该列。如果您打算删除表，请改用该 DROP TABLE语句。

如果从表中删除列，则这些列也会从它们所属的任何索引中删除。如果组成索引的所有列都被删除，那么索引也会被删除。

重命名、重新定义和重新排序列

、CHANGE和子句允许更改现有列的名称和定义MODIFY。 ALTER它们具有以下比较特征：

CHANGE是标准 SQL 的 MySQL 扩展。 MODIFY是 Oracle 兼容性的 MySQL 扩展。

要更改列以更改其名称和定义，请使用 CHANGE，指定旧名称和新名称以及新定义。例如，要将INT NOT NULL列从重命名为ato b并将其定义更改为 BIGINT在保留 NOT NULL属性的同时使用数据类型，请执行以下操作：

ALTER TABLE t1 CHANGE a b BIGINT NOT NULL;

要更改列定义但不更改其名称，请使用 CHANGE或MODIFY。对于 CHANGE，语法需要两个列名，因此您必须指定相同的名称两次才能保持名称不变。例如，要更改 column 的定义 b，请执行以下操作：

ALTER TABLE t1 CHANGE b b INT NOT NULL;

MODIFY在不更改名称的情况下更改定义更方便，因为它只需要列名一次：

ALTER TABLE t1 MODIFY b INT NOT NULL;

要更改列名但不更改其定义，请使用 CHANGE. 语法需要列定义，因此要保持定义不变，您必须重新指定列当前具有的定义。例如，要将INT NOT NULL列 从重命名b为a，请执行以下操作：

ALTER TABLE t1 CHANGE b a INT NOT NULL;

CHANGE对于使用or 的 列定义更改MODIFY，定义必须包括数据类型和应应用于新列的所有属性，而不是诸如PRIMARY KEYor 之类的索引属性UNIQUE。原始定义中存在但未为新定义指定的属性不会被继承。假设一列col1定义为INT UNSIGNED DEFAULT 1 COMMENT 'my column'，您按如下方式修改该列，仅打算更改INT为 BIGINT：

ALTER TABLE t1 MODIFY col1 BIGINT;

该语句将数据类型从 更改INT 为BIGINT，但它也删除了 UNSIGNED、DEFAULT和 COMMENT属性。要保留它们，语句必须明确包括它们：

ALTER TABLE t1 MODIFY col1 BIGINT UNSIGNED DEFAULT 1 COMMENT 'my column';

CHANGE对于使用or 的数据类型更改MODIFY，MySQL 会尽可能地将现有列值转换为新类型。

如果使用CHANGEorMODIFY 来缩短列上存在索引的列，并且生成的列长度小于索引长度，MySQL 会自动缩短索引。

对于由 重命名的列CHANGE，MySQL 自动将这些引用重命名为重命名的列：

对于由 重命名的列CHANGE，MySQL 不会自动将这些引用重命名为重命名的列：

要对表中的列重新排序，请使用FIRST and AFTERin CHANGEor MODIFY操作。

ALTER ... SET DEFAULT或ALTER ... DROP DEFAULT分别为列指定新的默认值或删除旧的默认值。如果删除旧的默认值并且列可以是NULL，则新的默认值是NULL。如果该列不能是 NULL，MySQL 将分配一个默认值，如第 11.5 节，“数据类型默认值”中所述。

主键和索引

DROP PRIMARY KEY删除 主键。如果没有主键，就会出错。有关主键性能特征的信息，尤其是 InnoDB表，请参阅 第 8.3.2 节，“主键优化”。

如果你添加一个UNIQUE INDEX或PRIMARY KEY到一个表，MySQL 将它存储在任何非唯一索引之前，以允许尽早检测重复键。

IGNORE是标准 SQL 的 MySQL 扩展。ALTER TABLE如果新表中的唯一键有重复，或者在启用严格模式时出现警告，它会控制工作方式。如果 IGNORE未指定，则复制会在出现重复键错误时中止并回滚。如果 IGNORE指定，则只有一行用于在唯一键上具有重复项的行。其他冲突的行被删除。不正确的值被截断为最接近的匹配可接受值。

从 MySQL 5.6.17 开始，该IGNORE子句已弃用，其使用会产生警告。 IGNORE在 MySQL 5.7 中被删除。

DROP INDEX删除索引。这是标准 SQL 的 MySQL 扩展。请参阅 第 13.1.24 节，“DROP INDEX 语句”。要确定索引名称，请使用 . SHOW INDEX FROM tbl_name

一些存储引擎允许您在创建索引时指定索引类型。说明符的语法 index_type是. 有关详细信息 ，请参阅第 13.1.13 节，“CREATE INDEX 语句”。首选位置在列列表之后。期望支持在将来的 MySQL 版本中删除列列表之前的选项。 USING type_nameUSING

index_option值指定索引的附加选项。有关允许 index_option值的详细信息，请参阅 第 13.1.13 节，“CREATE INDEX 语句”。

如果您ALTER TABLE在 MyISAM表上使用，则所有非唯一索引都在单独的批次中创建（对于REPAIR TABLE）。当你有很多索引时，这应该会ALTER TABLE更快。

对于MyISAM表，可以显式控制键更新。用于ALTER TABLE ... DISABLE KEYS告诉 MySQL 停止更新非唯一索引。然后用于ALTER TABLE ... ENABLE KEYS重新创建丢失的索引。MyISAM使用一种比逐个插入键快得多的特殊算法来执行此操作，因此在执行批量插入操作之前禁用键应该会大大加快速度。除了前面提到 的特权之外，使用 还ALTER TABLE ... DISABLE KEYS需要 特权。INDEX

虽然非唯一索引被禁用，但对于诸如SELECT和 之类的语句，它们将被忽略EXPLAIN，否则将使用它们。

在ALTER TABLE语句之后，可能需要运行ANALYZE TABLE以更新索引基数信息。请参阅 第 13.7.5.23 节，“SHOW INDEX 语句”。

外键和其他约束

FOREIGN KEY和 子句REFERENCES由 实现. _ 请参阅第 13.1.17.5 节，“外键约束”。对于其他存储引擎，这些子句被解析但被忽略。 InnoDBNDBADD [CONSTRAINT [symbol]] FOREIGN KEY [index_name] (...) REFERENCES ... (...)

CHECK约束子句被解析但被所有存储引擎忽略 。请参阅 第 13.1.17 节，“CREATE TABLE 语句”。接受但忽略语法子句的原因是为了兼容性，以便更容易地从其他 SQL 服务器移植代码，并运行使用引用创建表的应用程序。请参阅 第 1.7.2 节，“MySQL 与标准 SQL 的差异”。

对于ALTER TABLE，与 不同 CREATE TABLE，如果给定则ADD FOREIGN KEY忽略index_name并使用自动生成的外键名称。作为解决方法，包括CONSTRAINT用于指定外键名称的子句：

ADD CONSTRAINT name FOREIGN KEY (....) ...

和存储引擎支持使用删除InnoDB外 键： NDBALTER TABLE

ALTER TABLE tbl_name DROP FOREIGN KEY fk_symbol;

支持在同一 ALTER TABLE语句中添加和删除外键，ALTER TABLE ... ALGORITHM=INPLACE但不支持 ALTER TABLE ... ALGORITHM=COPY.

服务器禁止更改可能导致引用完整性丢失的外键列。解决方法是ALTER TABLE ... DROP FOREIGN KEY在更改列定义之前和ALTER TABLE ... ADD FOREIGN KEY之后使用。禁止更改的示例包括：

ALTER TABLE tbl_name RENAME new_tbl_name更改内部生成的外键约束名称和以字符串“ tbl_name_ibfk_ ”开头的用户定义的外键约束名称 以反映新的表名称。将以字符串“ _ibfk_ ”InnoDB开头的外键约束名称解释 为内部生成的名称。 tbl_name

更改字符集

要将表默认字符集和所有字符列 ( CHAR, VARCHAR, TEXT) 更改为新字符集，请使用如下语句：

ALTER TABLE tbl_name
CONVERT TO CHARACTER SET charset_name [COLLATE collation_name];

该语句还更改所有字符列的排序规则。如果您没有指定任何COLLATE子句来指示要使用的排序规则，该语句将使用字符集的默认排序规则。如果此归类不适合预期的表用途（例如，如果它将从区分大小写的归类更改为不区分大小写的归类），请明确指定归类。

对于具有一种数据类型 VARCHAR或其中一种 TEXT类型的列，CONVERT TO CHARACTER SET根据需要更改数据类型以确保新列的长度足以存储与原始列一样多的字符。例如，一个 TEXT列有两个长度字节，存储列中值的字节长度，最大为 65,535。对于一latin1 TEXT列，每个字符需要一个字节，因此该列最多可以存储 65,535 个字符。如果将列转换为utf8，则每个字符最多可能需要三个字节，最大可能长度为 3 × 65,535 = 196,605 字节。该长度不适合TEXT列的长度字节，因此 MySQL 将数据类型转换为 MEDIUMTEXT，这是长度字节可以记录值196,605的最小字符串类型。同样，VARCHAR 列可能会转换为 MEDIUMTEXT.

为避免刚才描述的类型的数据类型更改，请勿使用 CONVERT TO CHARACTER SET. 相反，用于 MODIFY更改单个列。例如：

ALTER TABLE t MODIFY latin1_text_col TEXT CHARACTER SET utf8;
ALTER TABLE t MODIFY latin1_varchar_col VARCHAR(M) CHARACTER SET utf8;

如果指定CONVERT TO CHARACTER SET binary，则CHAR、 VARCHAR和 TEXT列将转换为其相应的二进制字符串类型 ( BINARY、 VARBINARY、 BLOB)。这意味着列不再具有字符集，后续CONVERT TO操作也不适用于它们。

如果charset_name在 操作DEFAULT中，则使用系统变量 CONVERT TO CHARACTER SET命名的字符集 。character_set_database

ALTER TABLE t1 CHANGE c1 c1 BLOB;
ALTER TABLE t1 CHANGE c1 c1 TEXT CHARACTER SET utf8;

要仅更改表的默认字符集，请使用以下语句：

ALTER TABLE tbl_name DEFAULT CHARACTER SET charset_name;

这个词DEFAULT是可选的。默认字符集是在您没有为稍后添加到表中的列指定字符集时使用的字符集（例如，使用ALTER TABLE ... ADD column）。

启用系统变量（默认设置）时foreign_key_checks ，不允许在包含外键约束中使用的字符串列的表上进行字符集转换。foreign_key_checks解决方法是在执行字符集转换之前禁用 。在重新启用之前，必须对外键约束涉及的两个表进行转换 foreign_key_checks。foreign_key_checks 如果您仅在转换其中一个表后重新启用，则ON DELETE CASCADEorON UPDATE CASCADE 操作可能会由于在这些操作期间发生隐式转换而损坏引用表中的数据（错误 #45290、错误 #74816）。

丢弃和导入 InnoDB 表空间

InnoDB在其自己的 file-per-table 表空间中创建的 表可以 使用DISCARD TABLEPACEand IMPORT TABLESPACE子句从备份或从另一个 MySQL 服务器实例导入。请参阅 第 14.6.1.3 节，“导入 InnoDB 表”。

MyISAM 表的行顺序

ORDER BY使您能够创建具有特定顺序的行的新表。此选项主要在您知道大多数时间以特定顺序查询行时有用。通过在对表进行重大更改后使用此选项，您可能可以获得更高的性能。在某些情况下，如果表是按您以后要按其排序的列排序的，则 MySQL 的排序可能会更容易。

ORDER BY语法允许为排序指定一个或多个列名，每个列名后面可选地跟有ASCorDESC以分别指示升序或降序排序顺序。默认是升序。只允许列名作为排序标准；不允许任意表达。该子句应在任何其他子句之后给出。

ORDER BY对表没有意义， InnoDB因为InnoDB 总是根据 聚集索引对表行进行排序。

在分区表上使用时，ALTER TABLE ... ORDER BY仅对每个分区内的行进行排序。

分区选项

partition_options表示可与分区表一起用于重新分区、添加、删除、丢弃、合并和拆分分区以及执行分区维护的选项。

一个ALTER TABLE 语句可以包含一个PARTITION BYor REMOVE PARTITIONING子句作为对其他更改规范的补充，但PARTITION BYorREMOVE PARTITIONING子句必须在任何其他规范之后最后指定。、ADD PARTITION、DROP PARTITION、 COALESCE PARTITION、REORGANIZE PARTITION、EXCHANGE PARTITION、 和 选项不能与单个 中的其他更改规范组合ANALYZE PARTITION，因为刚刚列出的选项作用于单个分区。 CHECK PARTITIONREPAIR PARTITIONALTER TABLE

有关分区选项的更多信息，请参阅 第 13.1.17 节，“CREATE TABLE 语句”和 第 13.1.7.1 节，“ALTER TABLE 分区操作”。有关ALTER TABLE ... EXCHANGE PARTITION语句的信息和示例，请参阅 第 19.3.3 节，“用表交换分区和子分区”。