第13章SQL语句语法

MySQL 8.0支持原子数据定义语言（DDL）语句。 此功能称为 原子DDL 。 原子DDL语句将与DDL操作关联的数据字典更新，存储引擎操作和二进制日志写入组合到单个原子事务中。 即使服务器在操作期间停止，也会提交事务，并将适用的更改保留到数据字典，存储引擎和二进制日志中，或者回滚事务。

通过在MySQL 8.0中引入MySQL数据字典，可以实现Atomic DDL。 在早期的MySQL版本中，元数据存储在元数据文件，非事务性表和存储引擎特定的字典中，这需要中间提交。 MySQL数据字典提供的集中式事务元数据存储消除了这一障碍，使得将DDL语句操作重组为原子事务成为可能。

原子DDL功能在本节的以下主题中描述：

CREATE TABLE mysql.innodb_ddl_log（
  id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY，
  thread_id BIGINT UNSIGNED NOT NULL，
  类型INT UNSIGNED NOT NULL，
  space_id INT UNSIGNED，
  page_no INT未签名，
  index_id BIGINT UNSIGNED，
  table_id BIGINT UNSIGNED，
  old_file_path VARCHAR（512）COLLATE UTF8_BIN，
  new_file_path VARCHAR（512）COLLATE UTF8_BIN，
  KEY（thread_id单）
）;

mysql> SET GLOBAL innodb_print_ddl_logs = 1;
mysql> CREATE TABLE t1（c1 INT）ENGINE = InnoDB;

[注意] [000000] InnoDB：DDL日志插入：[DDL记录：DELETE SPACE，id = 18，thread_id = 7， 
space_id = 5，old_file_path =。/ test / t1.ibd]
[注意] [000000] InnoDB：DDL日志删除：按id 18
[注意] [000000] InnoDB：DDL日志插入：[DDL记录：REMOVE CACHE，id = 19，thread_id = 7， 
table_id = 1058，new_file_path = test / t1]
[注意] [000000] InnoDB：DDL日志删除：按id 19
[注意] [000000] InnoDB：DDL日志插入：[DDL记录：FREE，id = 20，thread_id = 7， 
space_id = 5，index_id = 132，page_no = 4]
[注意] [000000] InnoDB：DDL日志删除：按id 20
[注意] [000000] InnoDB：DDL log post ddl：begin for thread id：7
[注意] [000000] InnoDB：DDL日志发布ddl：end for thread id：7

ALTER {DATABASE | SCHEMA} [ db_name]
     alter_specification......

alter_specification：
    [DEFAULT] CHARACTER SET [=] charset_name
  | [DEFAULT] COLLATE [=]collation_name
  | DEFAULT ENCRYPTION [=] {'Y'| 'N'}

ALTER DATABASE 使您可以更改数据库的整体特征。 这些特征存储在数据字典中。 要使用 ALTER DATABASE ，您需要 ALTER 数据库 的 权限。 ALTER SCHEMA 是...的同义词 ALTER DATABASE 。

可以从第一个语法中省略数据库名称，在这种情况下，该语句将应用于默认数据库。

国家语言特色

该 CHARACTER SET 子句更改默认数据库字符集。 该 COLLATE 子句更改默认数据库排序规则。 第10章， 字符集，排序规则，Unicode ，讨论字符集和排序规则名称。

您可以分别使用 SHOW CHARACTER SET 和 SHOW COLLATION 语句 查看可用的字符集和排序规则 。 有关更多 信息， 请参见 第13.7.6.3节“显示字符集语法” 和 第13.7.6.4 节“显示字符集语法” 。

如果更改数据库的默认字符集或排序规则，则必须删除并重新创建使用数据库默认值的存储例程，以便它们使用新的默认值。 （在存储例程中，如果未明确指定字符集或排序规则，则具有字符数据类型的变量将使用数据库缺省值。请参见 第13.1.17节“创建过程和创建函数语法” 。）

加密

DEFAULT ENCRYPTION MySQL 8.0.16中引入的 该 子句定义了默认数据库加密，该加密由数据库中创建的表继承。 更改数据库的默认加密不会更改与架构关联的现有表的加密。 只有新创建的表才会继承默认的数据库加密。 在 ALTER DATABASE 没有 DEFAULT ENCRYPTION 子句的情况下 执行的 语句会保留现有的默认数据库加密。 如果 table_encryption_privilege_check 启用 该 变量， TABLE_ENCRYPTION_ADMIN 则需要 该 权限才能指定与设置不同的默认加密 default_table_encryption 设置。 有关更多信息，请参阅 为架构和常规表空间定义加密默认值 。

改变
    [DEFINER = user]
    活动event_name
    [安排时间表schedule]
    [完成[NOT] PRESERVE]
    [重命名new_event_name]
    [ENABLE | 禁用| 禁止在[SLAVE]
    [评论' string']
    [DO event_body]

该 ALTER EVENT 语句更改现有事件的一个或多个特征，而无需删除和重新创建它。 的语法的每个的 DEFINER ， ON SCHEDULE ， ON COMPLETION ， COMMENT ， ENABLE / DISABLE ，和 DO 条款是完全一样的当用于如 CREATE EVENT 。 （请参见 第13.1.13节“创建事件语法” 。）

任何用户都可以更改在该用户具有该 EVENT 权限 的数据库上定义的事件 。 当用户执行成功的 ALTER EVENT 语句时，该用户将成为受影响事件的定义者。

ALTER EVENT 仅适用于现有事件：

的MySQL> ALTER EVENT no_such_event 
     >      ON SCHEDULE 
     >        ERROR 1517（HY000）：未知事件'no_such_event'EVERY '2:3' DAY_HOUR;

在以下每个示例中，假设命名事件 myevent 的定义如下所示：

创造事件myevent
    按照时间表
      每6个小时
    评论'示例评论。'
    做
      更新myschema.mytable SET mycol = mycol + 1;

以下语句将计划 myevent 从立即开始每六小时 更改为 每十二小时一次，从语句运行开始四小时开始：

改变事件myevent
    按照时间表
      每12个小时
    STARTS CURRENT_TIMESTAMP + INTERVAL 4小时;

可以在单个语句中更改事件的多个特征。 此示例将执行的SQL语句更改为 myevent 删除所有记录的 语句 mytable ; 它还会更改事件的计划，使其在 ALTER EVENT 运行 此 语句 后一天执行一次 。

改变事件myevent
    按照时间表
      在CURRENT_TIMESTAMP + INTERVAL 1天
    做
      TRUNCATE TABLE myschema.mytable;

ALTER EVENT 仅为要更改的特征 在 语句中 指定选项 ; 省略的选项保留其现有值。 这包括任何默认值 CREATE EVENT ，例如 ENABLE 。

要禁用 myevent ，请使用以下 ALTER EVENT 语句：

改变事件myevent
    禁用;

该 ON SCHEDULE 子句可以使用涉及内置MySQL函数和用户变量的表达式来获取 它包含的 任何 timestamp 或 interval 值。 您不能在此类表达式中使用存储的例程或用户定义的函数，也不能使用任何表引用; 但是，你可以使用 SELECT FROM DUAL 。 对于这两个 ALTER EVENT 和 CREATE EVENT 陈述 都是如此 。 在这种情况下，特别不允许引用存储例程，用户定义函数和表，并且会因错误而失败（参见Bug＃22830）。

虽然 在其 子句 ALTER EVENT 中包含另一个 ALTER EVENT 语句的 DO 语句似乎成功，但是当服务器尝试执行生成的已调度事件时，执行将失败并显示错误。

要重命名事件，请使用 ALTER EVENT 语句的 RENAME TO 子句。 此语句将事件重命名 myevent 为 yourevent ：

改变事件myevent
    重命名给你;

您还可以使用 ALTER EVENT ... RENAME TO ... 和 db_name.event_name 表示法 将事件移动到其他数据库 ，如下所示：

ALTER EVENT olddb.myevent
    重命名为newdb.myevent;

要执行前一个语句，执行它的用户必须 EVENT 同时拥有 olddb 和 newdb 数据库 的 权限 。

该值 DISABLE ON SLAVE 用于复制从站而不是 ENABLE 或 DISABLE 表示在主站上创建并复制到从站的事件，但不在从站上执行。 通常， DISABLE ON SLAVE 根据需要自动设置; 但是，在某些情况下，您可能需要或需要手动更改它。 有关 更多信息 ， 请参见 第17.4.1.16节“调用的特性的复制” 。

改变功能func_name[ characteristic...]

characteristic：
    评论' string'
  | 语言SQL
  | {包含SQL | 没有SQL | 读取SQL数据| 修改SQL DATA}
  | SQL SECURITY {DEFINER | INVOKER}

此语句可用于更改存储函数的特征。 可以在 ALTER FUNCTION 语句中 指定多个更改 。 但是，您无法使用此语句更改存储函数的参数或正文; 要进行此类更改，您必须使用 DROP FUNCTION 和 删除并重新创建函数 CREATE FUNCTION 。

您必须拥有 ALTER ROUTINE 该功能 的 权限。 （该权限自动授予函数创建者。）如果启用了二进制日志记录，则该 ALTER FUNCTION 语句可能还需要该 SUPER 特权，如 第24.7节“存储程序二进制日志记录”中所述 。

更改实例 instance_action

instance_action：{
    旋转INNODB MASTER KEY
  | 旋转BINLOG MASTER KEY
  | RELOAD TLS [没有错误的错误]
}

ALTER INSTANCE 定义适用于MySQL服务器实例的操作。 该声明支持以下操作：

ALTER LOGFILE GROUP logfile_group
    ADD UNDOFILE' file_name'
    [INITIAL_SIZE [=] size]
    [等待]
    发动机[=] engine_name

此语句将 UNDO 名为' file_name ' 的 文件 添加 到现有日志文件组 logfile_group 。 一个 ALTER LOGFILE GROUP 语句有一个且只有一个 ADD UNDOFILE 条款。 DROP UNDOFILE 目前不支持 任何 条款。

可选 INITIAL_SIZE 参数设置 UNDO 文件的初始大小（以字节为单位）; 如果未指定，则初始大小默认为134217728（128 MB）。 您可以选择 size 使用一个字母的缩写，一个数量级，类似于中使用的那些 my.cnf 。 通常，这是字母 M （兆字节）或 G （千兆字节）之一。 （Bug＃13116514，Bug＃16104705，Bug＃62858）

在32位系统上，支持的最大值为 INITIAL_SIZE 4294967296（4 GB）。 （Bug＃29186）

允许的最小值为 INITIAL_SIZE 1048576（1 MB）。 （Bug＃29574）

的 ENGINE 参数（必需）确定这是由该日志文件组所使用的，与存储引擎 engine_name 是所述存储引擎的名称。 目前，唯一可接受的值 engine_name 是 “ NDBCLUSTER ” 和 “ NDB ” 。 这两个值是等价的。

下面是一个示例，它假定 lg_3 已经使用创建 了日志文件组 CREATE LOGFILE GROUP （请参见 第13.1.16节“CREATE LOGFILE GROUP语法” ）：

ALTER LOGFILE GROUP lg_3
    添加UNDOFILE'under_10.dat'
    INITIAL_SIZE = 32M
    ENGINE = NDBCLUSTER;

当 ALTER LOGFILE GROUP 与 ENGINE = NDBCLUSTER （替代地 ENGINE = NDB ）一起使用时， UNDO 在每个NDB集群数据节点上创建日志文件。 您可以 UNDO 通过查询 INFORMATION_SCHEMA.FILES 表 来验证 文件是否已创建并获取有关它们的信息 。 例如：

mysql> SELECT FILE_NAME, LOGFILE_GROUP_NUMBER, EXTRA
    - > FROM INFORMATION_SCHEMA.FILES
    - >WHERE LOGFILE_GROUP_NAME = 'lg_3';
+ ------------- + ---------------------- + ------------ ---- +
| FILE_NAME | LOGFILE_GROUP_NUMBER | 额外|
+ ------------- + ---------------------- + ------------ ---- +
| newdata.dat | 0 | CLUSTER_NODE = 3 |
| newdata.dat | 0 | CLUSTER_NODE = 4 |
| undo_10.dat | 11 | CLUSTER_NODE = 3 |
| undo_10.dat | 11 | CLUSTER_NODE = 4 |
+ ------------- + ---------------------- + ------------ ---- +
4行（0.01秒）

（参见 第25.11节“INFORMATION_SCHEMA文件表” 。）

用于的内存 UNDO_BUFFER_SIZE 来自全局池，其大小由 SharedGlobalMemory 数据节点配置参数 的值确定 。 这包括通过设置 InitialLogFileGroup 数据节点配置参数 对此选项隐含的任何默认值 。

ALTER LOGFILE GROUP 仅适用于NDB Cluster的磁盘数据存储。 有关更多信息，请参见 第22.5.13节“NDB集群磁盘数据表” 。

更改程序proc_name[ characteristic...]

characteristic：
    评论' string'
  | 语言SQL
  | {包含SQL | 没有SQL | 读取SQL数据| 修改SQL DATA}
  | SQL SECURITY {DEFINER | INVOKER}

此语句可用于更改存储过程的特征。 可以在 ALTER PROCEDURE 语句中 指定多个更改 。 但是，您无法使用此语句更改存储过程的参数或主体; 要进行此类更改，您必须使用 DROP PROCEDURE 和 删除并重新创建该过程 CREATE PROCEDURE 。

您必须拥有 ALTER ROUTINE 该过程 的 特权。 默认情况下，该权限自动授予过程创建者。 可以通过禁用 automatic_sp_privileges 系统变量 来更改此行为 。 请参见 第24.2.2节“存储例程和MySQL特权” 。

更改服务器   server_name
    选项（option[，option] ...）

更改服务器信息 server_name ，调整 CREATE SERVER 语句中 允许的任何选项 。 mysql.servers 表中 的相应字段会相应 更新。 此声明需要该 SUPER 权限。

例如，要更新 USER 选项：

ALTER SERVER的选项（USER'sally'）;

ALTER SERVER 导致隐式提交。 请参见 第13.3.3节“导致隐式提交的语句” 。

ALTER SERVER 无论正在使用的日志记录格式如何，都不会写入二进制日志。

ALTER TABLE tbl_name
    [ alter_specification[，alter_specification] ...]
    [ partition_options]

alter_specification：
     table_options
  | 添加[栏目] 
        [第一个| 之后]col_name column_definitioncol_name
  | 添加[栏目]（，...）col_name column_definition
  | 添加{INDEX | KEY} [ index_name]
        [ index_type]（key_part，...）[ index_option] ......
  | ADD {FULLTEXT | SPATIAL} [INDEX | KEY] [ index_name]
        （key_part，......）[ index_option] ......
  | 添加[CONSTRAINT [ symbol]] PRIMARY KEY
        [ index_type]（key_part，...）
        [ index_option] ......
  | ADD [CONSTRAINT [ symbol]] UNIQUE [INDEX | KEY]
        [ index_name] [ index_type]（key_part，...）
        [ index_option] ......
  | 添加[CONSTRAINT [ symbol]]外键
        [ index_name]（col_name，...）
         reference_definition
  | ADD check_constraint_definition
  | DROP CHECK symbol
  | 更改检查symbol[NOT]强制执行
  | 算法[=] {DEFAULT | INSTANT | INPLACE | COPY}
  | ALTER [COLUMN] col_name{SET DEFAULT literal| DROP DEFAULT}
  | ALTER INDEX index_name{VISIBLE | 无形}
  | 更改[栏目] 
        [第一|后]old_col_name new_col_name column_definitioncol_name
  | [DEFAULT] CHARACTER SET [=] charset_name[COLLATE [=] collation_name]
  | 转换为字符集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 KEYfk_symbol
  | 力
  | LOCK [=] {DEFAULT | NONE | SHARED | EXCLUSIVE}
  | 修改[专栏] 
        [第一个| 之后]col_name column_definitioncol_name
  | ORDER BY col_name[，col_name] ......
  | RENAME COLUMN old_col_nameTO new_col_name
  | 重命名{INDEX | KEY} old_index_name至new_index_name
  | 重命名[TO | AS]new_tbl_name
  | {WITHOUT | WITH}验证
  | 添加分区（partition_definition）
  | DROP PARTITION partition_names
  | DISCARD PARTITION { partition_names| ALL} TABLESPACE
  | IMPORT PARTITION { partition_names| ALL} TABLESPACE
  | TRUNCATE PARTITION { partition_names| 所有}
  | COALESCE PARTITION number
  | 重新划分partition_names（partition_definitions）
  | partition_name表tbl_name[[WITH | WITHOUT}验证]的交换分区
  | 分析分区{ partition_names| 所有}
  | 检查分区{ partition_names| 所有}
  | OPTIMIZE PARTITION { partition_names| 所有}
  | REBUILD PARTITION { partition_names| 所有}
  | 修复分区{ partition_names| 所有}
  | 删除分区

key_part：{ col_name[（length）] | （expr）} [ASC | DESC]

index_type：
    使用{BTREE | HASH}

index_option：
    KEY_BLOCK_SIZE [=] value
  | index_type
  | 与PARSER parser_name
  | 评论' string'
  | {VISIBLE | 无形}

check_constraint_definition：
    [CONSTRAINT [ symbol]] CHECK（expr）[[NOT] ENFORCED]

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
  | 评论[=]' string'
  | COMPRESSION [=] {'ZLIB'|'LZ4'|'NONE'}
  | 连接[=]' connect_string'
  | {DATA | INDEX} DIRECTORY [=]' absolute path to directory'
  | DELAY_KEY_WRITE [=] {0 | 1}
  | ENCRYPTION [=] {'Y'| 'N'}
  | 发动机[=]engine_name
  | INSERT_METHOD [=] {NO | 第一个| 最后}
  | KEY_BLOCK_SIZE [=] value
  | MAX_ROWS [=] value
  | MIN_ROWS [=]value
  | PACK_KEYS [=] {0 | 1 | 默认}
  | 密码[=]' 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] ......）

partition_options：
    （见CREATE TABLE选项）

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

该 ALTER TABLE 语句 还有其他几个方面 ，本节中的以下主题对此进行了描述：

表格选项

table_options 意味着可以在可以使用的一种表选项 CREATE TABLE 语句，比如 ENGINE ， AUTO_INCREMENT ， AVG_ROW_LENGTH ， MAX_ROWS ， ROW_FORMAT ，或 TABLESPACE 。

有关所有表选项的说明，请参见 第13.1.20节“CREATE TABLE语法” 。 但是， ALTER TABLE 忽略 DATA DIRECTORY 并 INDEX DIRECTORY 作为表选项给出。 ALTER TABLE 仅允许它们作为分区选项，并要求您拥有该 FILE 权限。

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

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

性能和空间要求

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

该 ALGORITHM 条款是可选的。 如果 ALGORITHM 省略 该 子句，MySQL将使用 支持它的 ALGORITHM=INSTANT 存储引擎和 ALTER TABLE 子句。 否则， ALGORITHM=INPLACE 使用。 如果 ALGORITHM=INPLACE 不支持， ALGORITHM=COPY 则使用。

指定 ALGORITHM 子句需要操作将指定的算法用于支持它的子句和存储引擎，否则将失败并返回错误。 指定 ALGORITHM=DEFAULT 与省略该 ALGORITHM 子句 相同 。

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

前面提到的异常是 ALTER TABLE 块在准备从表和表定义高速缓存中清除过时的表结构时读取（而不仅仅是写入）。 此时，它必须获得独占锁。 为此，它等待当前读者完成，并阻止新的读写。

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

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

对于 InnoDB 表， 在驻留在 共享表空间中 的表上 ALTER TABLE 使用该 COPY 算法 的 操作 可以增加 表 空间使用的空间量。 此类操作需要与表中的数据和索引一样多的额外空间。 对于驻留在共享表空间中的表，操作期间使用的额外空间不会释放回操作系统，因为它是驻留在 每个表文件表 空间中的表。

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

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

ALTER TABLE operations that support the INSTANT algorithm include:

For more information about operations that support ALGORITHM=INSTANT, see Section 15.12.1, “Online DDL Operations”.

ALTER TABLE upgrades MySQL 5.5 temporal columns to 5.6 format for ADD COLUMN, CHANGE COLUMN, MODIFY COLUMN, ADD INDEX, and FORCE operations. This conversion cannot be done using the INPLACE algorithm because the table must be rebuilt, so specifying ALGORITHM=INPLACE in these cases results in an error. Specify ALGORITHM=COPY if necessary.

If an ALTER TABLE operation on a multicolumn index used to partition a table by KEY changes the order of the columns, it can only be performed using ALGORITHM=COPY.

The WITHOUT VALIDATION and WITH VALIDATION clauses affect whether ALTER TABLE performs an in-place operation for virtual generated column modifications. See Section 13.1.9.2, “ALTER TABLE and Generated Columns”.

NDB Cluster 8.0 supports online operations using the same ALGORITHM=INPLACE syntax used with the standard MySQL Server. See Section 22.5.14, “Online Operations with ALTER TABLE in NDB Cluster”, for more information.

ALTER TABLE with DISCARD ... PARTITION ... TABLESPACE or IMPORT ... PARTITION ... TABLESPACE does not create any temporary tables or temporary partition files.

ALTER TABLE with ADD PARTITION, DROP PARTITION, COALESCE PARTITION, REBUILD PARTITION, or REORGANIZE PARTITION does not create temporary tables (except when used with NDB tables); however, these operations can and do create temporary partition files.

ADD or DROP operations for RANGE or LIST partitions are immediate operations or nearly so. ADD or COALESCE operations for HASH or KEY partitions copy data between all partitions, unless LINEAR HASH or LINEAR KEY was used; this is effectively the same as creating a new table, although the ADD or COALESCE operation is performed partition by partition. REORGANIZE operations copy only changed partitions and do not touch unchanged ones.

For MyISAM tables, you can speed up index re-creation (the slowest part of the alteration process) by setting the myisam_sort_buffer_size system variable to a high value.

Concurrency Control

For ALTER TABLE operations that support it, you can use the LOCK clause to control the level of concurrent reads and writes on a table while it is being altered. Specifying a non-default value for this clause enables you to require a certain amount of concurrent access or exclusivity during the alter operation, and halts the operation if the requested degree of locking is not available.

Only LOCK = DEFAULT is permitted for operations that use ALGORITHM=INSTANT. The other LOCK clause parameters are not applicable.

The parameters for the LOCK clause are:

添加和删​​除列

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

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

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

如果从表中删除列，则列也将从它们所属的任何索引中删除。 如果删除构成索引的所有列，则也会删除索引。 如果使用 CHANGE 或 MODIFY 缩短列上存在索引的列，并且结果列长度小于索引长度，MySQL会自动缩短索引。

对于 ALTER TABLE ... ADD ，如果列具有使用非确定性函数的表达式默认值，则该语句可能会产生警告或错误。 有关详细信息，请参见 第17.1.3.6节“使用GTID进行复制的限制” 。

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

在 CHANGE ， MODIFY ， RENAME COLUMN ，和 ALTER 条款允许的名称和现有列的定义被改变。 它们具有以下比较特征：

CHANGE 是标准SQL的MySQL扩展。 MODIFY 并且 RENAME COLUMN 是Oracle兼容性的MySQL扩展。

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

ALTER TABLE t1 CHANGE ab BIGINT NOT NULL;

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

ALTER TABLE t1 CHANGE bb INT NOT NULL;

MODIFY 更改定义而不更改名称更方便，因为它只需要列名称一次：

ALTER TABLE t1 MODIFY b INT NOT NULL;

要更改列名但不更改其定义，请使用 CHANGE 或 RENAME COLUMN 。 使用时 CHANGE ，语法需要列定义，因此要保持定义不变，必须重新指定列当前具有的定义。 例如，要重命名 INT NOT NULL 的列 b 到 a ，这样做：

ALTER TABLE t1 CHANGE ba INT NOT NULL;

RENAME COLUMN 更改名称而不更改定义更方便，因为它只需要旧名称和新名称：

ALTER TABLE t1 RENAME COLUMN b TO a;

通常，您不能将列重命名为表中已存在的名称。 但是，有时情况并非如此，例如当您交换名称或将其移动一个循环时。 如果表具有名为 a ,, b 和的 列 c ，则这些是有效的操作：

- 交换a和b
ALTER TABLE t1 RENAME COLUMN a TO b，
               RENAME COLUMN b TO a;
- 通过循环“旋转”a，b，c
ALTER TABLE t1 RENAME COLUMN a TO b，
               RENAME COLUMN b TO c，
               RENAME COLUMN c TO a;

对于使用 CHANGE 或的 列定义更改 MODIFY ，定义必须包括应该应用于新列的数据类型和所有属性，而不是索引属性（如 PRIMARY KEY 或） 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 或的 数据类型更改 MODIFY ，MySQL尝试尽可能将现有列值转换为新类型。

如果使用 CHANGE 或 MODIFY 缩短列上存在索引的列，并且结果列长度小于索引长度，MySQL会自动缩短索引。

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

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

要重新排序表中的列，请使用 FIRST and AFTER in CHANGE 或 MODIFY operations。

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

主键和索引

DROP PRIMARY KEY 丢弃 主键 。 如果没有主键，则会发生错误。 有关主键性能特征的信息，尤其是 InnoDB 表 的性能特征 ，请参见 第8.3.2节“主键优化” 。

如果您 向表中 添加一个 UNIQUE INDEX 或 PRIMARY KEY 多个表，MySQL会在任何非唯一索引之前存储它，以便尽早检测重复键。

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

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

index_option values指定索引的其他选项。 USING 就是这样一个选择。 有关允许 index_option 值的 详细信息 ，请参见 第13.1.15节“CREATE INDEX语法” 。

RENAME INDEX old_index_name TO new_index_name 重命名索引。 这是标准SQL的MySQL扩展。 表的内容保持不变。 old_index_name 必须是表中未被同一 ALTER TABLE 语句 删除的现有索引的名称 。 new_index_name 是新索引名称，在应用更改后，不能复制结果表中索引的名称。 索引名称都不能 PRIMARY 。

如果 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.6.22节“SHOW INDEX语法” 。

该 ALTER INDEX 操作允许索引可见或不可见。 优化程序不使用不可见索引。 索引可见性的修改适用于主键以外的索引（显式或隐式）。 此功能是存储引擎中性（支持任何引擎）。 有关更多信息，请参见 第8.3.12节“不可见索引” 。

外键和其他限制

在 FOREIGN KEY 和 REFERENCES 条款由支持 InnoDB 和 NDB 存储引擎，它实现 。 请参见 第15.6.1.5节“InnoDB和FOREIGN KEY约束” 。 对于其他存储引擎，将解析子句但忽略这些子句。 ADD [CONSTRAINT [symbol]] FOREIGN KEY [index_name] (...) REFERENCES ... (...)

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

添加约束外name键（......）......

MySQL Server和NDB Cluster都支持使用 ALTER TABLE 删除外键：

ALTER TABLE tbl_nameDROP 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_ ” 开头 以反映新表名称的 用户定义的外键约束名称 。 InnoDB 将以字符串 “ tbl_name _ibfk_ ” 开头的外键约束名称解释 为内部生成的名称。

在MySQL 8.0.16之前， ALTER TABLE 仅允许以下限制版本的 CHECK 约束添加语法，该语法被解析并被忽略：

添加检查（expr）

从MySQL 8.0.16开始， ALTER TABLE 允许 CHECK 添加，删除或更改现有表的约束：

在 DROP CHECK 和 ALTER CHECK 条款是MySQL的扩展标准SQL。

如果表更改导致违反强制 CHECK 约束，则会发生错误并且不会修改表。 发生错误的操作示例：

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

更改字符集

要更改默认的表字符集和所有字符列（ CHAR ， VARCHAR ， TEXT ）到一个新的字符集，使用这样的语句：

ALTER TABLE tbl_nameCONVERT TO CHARACTER SET charset_name;

该语句还会更改所有字符列的排序规则。 如果指定no 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文本字符集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_nameDEFAULT CHARACTER SET charset_name;

这个词 DEFAULT 是可选的。 如果未指定稍后添加到表中的列的字符集（例如，with ALTER TABLE ... ADD column ） ，则默认字符集是使用的字符集 。

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

丢弃和导入InnoDB表空间

一个 InnoDB 在自己创建的表 文件的每个表的 表空间可以被丢弃，并使用进口 DISCARD TABLESPACE 和 IMPORT TABLESPACE 选项。 这些选项可用于从备份导入每个表的文件表空间，或者将每个表的文件表空间从一个数据库服务器复制到另一个数据库服务器。 请参见 第15.6.3.7节“将表空间复制到另一个实例” 。

MyISAM表的行顺序

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

ORDER BY 语法允许为排序指定一个或多个列名，每个列名可选地可以分别跟随 ASC 或 DESC 指示升序或降序排序。 默认为升序。 只允许列名作为排序标准; 不允许使用任意表达式。 该条款应在任何其他条款之后最后给出。

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

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

分区选项

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

这是可能的 ALTER TABLE 语句包含一个 PARTITION BY 或 REMOVE PARTITIONING 子句中，除其他更改规格，但 PARTITION BY 还是 REMOVE PARTITIONING 子句必须最后任何其他规格后指定。 的 ADD PARTITION ， DROP PARTITION ， DISCARD PARTITION ， IMPORT PARTITION ， COALESCE PARTITION ， REORGANIZE PARTITION ， EXCHANGE PARTITION ， ANALYZE PARTITION ， CHECK PARTITION ，和 REPAIR PARTITION 选项不能与其他单一更改规格组合 ALTER TABLE ，因为选择刚上市就单个分区的行为。

有关分区选项的更多信息，请参见 第13.1.20节“CREATE TABLE语法” 和 第13.1.9.1节“ALTER TABLE分区操作” 。 有关 ALTER TABLE ... EXCHANGE PARTITION 语句的 信息和示例 ，请参见 第23.3.3节“使用表交换分区和子分区” 。

ALTER TABLE t1 ANALYZE PARTITION p1，ANALYZE PARTITION p2;

ALTER TABLE t1 ANALYZE PARTITION p1，CHECK PARTITION p2;

ALTER TABLE t1 ANALYZE PARTITION p1，p2;

ALTER TABLE t1 ANALYZE PARTITION p1;
ALTER TABLE t1检查分区p2;