PolarDB MySQL版DDL操作指南

PolarDB MySQL版8.0.2版本

PolarDB MySQL版8.0.1版本

PolarDB MySQL版5.7版本

PolarDB MySQL版5.6版本

PolarDB MySQL版8.0.2版本

PolarDB MySQL版8.0.1版本

PolarDB MySQL版5.7版本

PolarDB MySQL版5.6版本

PolarDB MySQL版8.0.2版本

1. 秒级加字段功能仅支持将列添加至表的末尾。当表未指定主键时，需要将参数implicit_primary_key的值设置为OFF，以避免在执行秒级加字段操作时因表的最末尾的隐式主键列导致加列操作失败。除此之外，不支持在压缩表（ROW_FORMAT=COMPRESSED）、带有全文索引的表以及临时表上执行秒级加字段操作。如果集群不支持使用秒级加字段功能，增加字段将使用INPLACE方式执行DDL。此时需要进行全表重建，重建期间允许并发读写操作。您也可以通过并行DDL功能进行加速。

   此外，若您的表中存在列存索引，由于加列操作需要重建列存索引，因此，不支持对含有列存索引的表执行秒级加列操作。您可以将参数loose_imci_enable_add_column_instant_ddl的值设置为ON来开启秒级加列功能，此时，PolarDB会在后台异步重建列存索引，重建期间列存索引暂不可用，详情请参见动态增加或删除列存索引的DDL语法。

2. 扩展VARCHAR长度时，存储VARCHAR列长度所需的字节数需要保持一致，才能支持快速列扩展。具体来说，对于0~255个字节的VARCHAR列，只需要一个Byte存储长度。而对于大于等于256字节的VARCHAR列，就需要两个Bytes存储长度。只有控制VARCHAR列长度的扩展范围，比如从0~255字节或从256字节扩展到更大的范围，才能保证在执行ALTER TABLE时只修改元数据。即当修改VARCHAR列的长度从小于256字节扩展到大于256字节的长度时，PolarDB默认使用Copy DDL，即全程锁表，不支持DML写操作，仅支持读操作。

   当您不确定自己修改VARCHAR列的范围是否满足上述条件时，可以使用ALGORITHM=INPLACE指定采用INPLACE算法执行当前DDL操作。此时，如果不支持快速列扩展，则会直接报错。示例如下：

   ALTER TABLE table_name ALGORITHM=INPLACE, CHANGE COLUMN c1 c1 VARCHAR(256);
   
   ERROR 0A000: ALGORITHM=INPLACE is not supported. Reason: Cannot change column type INPLACE. Try ALGORITHM=COPY.

   VARCHAR类型属于变长存储类型，磁盘仅存储实际长度，因此建议您在使用VARCHAR类型的字段时，考虑将最大长度直接调整到256个字节以上，以避免在扩展字段时可能需要使用COPY算法。

3. 当满足以下条件时，将列的字符集从UTF8mb3修改至UTF8mb4仅修改元数据，无需修改数据。否则，需要使用COPY算法进行表重建，且重建期间全程锁表，目标表只能读，不能执行写入操作。

   • 列类型为CHAR、VARCHAR、ENUM以及TEXT类型。

   • 修改的列上不存在任何索引。

   • 字符集转换前后，列的最大存储长度均小于256或均大于255。

   您可以通过指定ALGORITHM=INPLACE来强制使用非重建表的方式执行DDL，如果需要使用COPY算法才能执行时，会立刻返回报错。示例如下：

   ALTER TABLE test modify column b char(1) CHARACTER SET utf8mb4 default null,algorithm = inplace;
   ERROR 1846 (0A000): ALGORITHM=INPLACE is not supported. Reason: Cannot change column type INPLACE. Try ALGORITHM=COPY.

4. 仅当数据类型的存储大小不发生改变，且向ENUM或SET的末尾追加元素时，才可以仅修改元数据，不重建整张表。否则需要使用COPY算法进行表重建。

PolarDB MySQL版8.0.1版本

1. 秒级加字段功能仅支持将列添加至表的末尾。当表未指定主键时，需要将参数implicit_primary_key的值设置为OFF，以避免在执行秒级加字段操作时因表的最末尾的隐式主键列导致加列操作失败。除此之外，不支持在压缩表（ROW_FORMAT=COMPRESSED）、带有全文索引的表以及临时表上执行秒级加字段操作。如果集群不支持使用秒级加字段功能，增加字段将使用INPLACE方式执行DDL。此时需要进行全表重建，重建期间允许并发读写操作。您也可以通过并行DDL功能进行加速。

   此外，若您的表中存在列存索引，由于加列操作需要重建列存索引，因此，不支持对含有列存索引的表执行秒级加列操作。您可以将参数loose_imci_enable_add_column_instant_ddl的值设置为ON来开启秒级加列功能，此时，PolarDB会在后台异步重建列存索引，重建期间列存索引暂不可用，详情请参见动态增加或删除列存索引的DDL语法。

2. 扩展VARCHAR长度时，存储VARCHAR列长度所需的字节数需要保持一致，才能支持快速列扩展。具体来说，对于0~255个字节的VARCHAR列，只需要一个Byte存储长度。而对于大于等于256字节的VARCHAR列，就需要两个Bytes存储长度。只有控制VARCHAR列长度的扩展范围，比如从0~255字节或从256字节扩展到更大的范围，才能保证在执行ALTER TABLE时只修改元数据。即当修改VARCHAR列的长度从小于256字节扩展到大于256字节的长度时，PolarDB默认使用Copy DDL，即全程锁表，不支持DML写操作，仅支持读操作。

   当您不确定自己修改VARCHAR列的范围是否满足上述条件时，可以使用ALGORITHM=INPLACE指定采用INPLACE算法执行当前DDL操作。此时，如果不支持快速列扩展，则会直接报错。示例如下：

   ALTER TABLE table_name ALGORITHM=INPLACE, CHANGE COLUMN c1 c1 VARCHAR(256);
   
   ERROR 0A000: ALGORITHM=INPLACE is not supported. Reason: Cannot change column type INPLACE. Try ALGORITHM=COPY.

   VARCHAR类型属于变长存储类型，磁盘仅存储实际长度，因此建议您在使用VARCHAR类型的字段时，考虑将最大长度直接调整到256个字节以上，以避免在扩展字段时可能需要使用COPY算法。

3. 当参数loose_innodb_support_instant_modify_charset的值为ON，且满足以下条件时，将列的字符集从UTF8mb3修改至UTF8mb4仅修改元数据，无需修改数据。否则，需要使用COPY算法进行表重建，且重建期间全程锁表，目标表只能读，不能执行写入操作。

   • 列类型为CHAR、VARCHAR、ENUM以及TEXT类型。

   • 修改的列上不存在任何索引。

   • 字符集转换前后，列的最大存储长度均小于256或均大于255。

   您可以通过指定ALGORITHM=INPLACE来强制使用非重建表的方式执行DDL，如果需要使用COPY算法才能执行时，会立刻返回报错。示例如下：

   ALTER TABLE test modify column b char(1) CHARACTER SET utf8mb4 default null,algorithm = inplace;
   ERROR 1846 (0A000): ALGORITHM=INPLACE is not supported. Reason: Cannot change column type INPLACE. Try ALGORITHM=COPY.

4. 仅当数据类型的存储大小不发生改变，且向ENUM或SET的末尾追加元素时，才可以仅修改元数据，不重建整张表。否则需要使用COPY算法进行表重建。

PolarDB MySQL版5.7版本

1. 开启秒级加字段功能需要将参数loose_innodb_support_instant_add_column的值设置为ON，且仅支持将列添加至表的末尾。当表未指定主键时，需要将参数implicit_primary_key的值设置为OFF，以避免在执行秒级加字段操作时因表的最末尾的隐式主键列导致加列操作失败。除此之外，不支持在压缩表（ROW_FORMAT=COMPRESSED）、带有全文索引的表以及临时表上执行秒级加字段操作。如果集群不支持使用秒级加字段功能，增加字段将使用INPLACE方式执行DDL。此时需要进行全表重建，重建期间允许并发读写操作。您也可以通过并行DDL功能进行加速。

2. 扩展VARCHAR长度时，存储VARCHAR列长度所需的字节数需要保持一致，才能支持快速列扩展。具体来说，对于0~255个字节的VARCHAR列，只需要一个Byte存储长度。而对于大于等于256字节的VARCHAR列，就需要两个Bytes存储长度。只有控制VARCHAR列长度的扩展范围，比如从0~255字节或从256字节扩展到更大的范围，才能保证在执行ALTER TABLE时只修改元数据。即当修改VARCHAR列的长度从小于256字节扩展到大于256字节的长度时，PolarDB默认使用Copy DDL，即全程锁表，不支持DML写操作，仅支持读操作。

   当您不确定自己修改VARCHAR列的范围是否满足上述条件时，可以使用ALGORITHM=INPLACE指定采用INPLACE算法执行当前DDL操作。此时，如果不支持快速列扩展，则会直接报错。示例如下：

   ALTER TABLE table_name ALGORITHM=INPLACE, CHANGE COLUMN c1 c1 VARCHAR(256);
   
   ERROR 0A000: ALGORITHM=INPLACE is not supported. Reason: Cannot change column type INPLACE. Try ALGORITHM=COPY.

   VARCHAR类型属于变长存储类型，磁盘仅存储实际长度，因此建议您在使用VARCHAR类型的字段时，考虑将最大长度直接调整到256个字节以上，以避免在扩展字段时可能需要使用COPY算法。

3. 仅当数据类型的存储大小不发生改变，且向ENUM或SET的末尾追加元素时，才可以仅修改元数据，不重建整张表。否则需要使用COPY算法进行表重建。

PolarDB MySQL版5.6版本

1. 开启秒级加字段功能需要将参数loose_innodb_support_instant_add_column的值设置为ON，且仅支持将列添加至表的末尾。当表未指定主键时，需要将参数implicit_primary_key的值设置为OFF，以避免在执行秒级加字段操作时因表的最末尾的隐式主键列导致加列操作失败。除此之外，不支持在压缩表（ROW_FORMAT=COMPRESSED）、带有全文索引的表、临时表以及分区表上执行秒级加字段操作。如果集群不支持使用秒级加字段功能，增加字段将使用INPLACE方式执行DDL。此时需要进行全表重建，重建期间允许并发读写操作。

   说明

   PolarDB MySQL版5.6版本的秒级加列功能目前处于灰度阶段，如需使用，请前往配额中心，根据配额ID polardb_mysql_iac_56找到配额名称，在对应的操作列单击申请来开通该功能。

2. 仅当数据类型的存储大小不发生改变，且向ENUM或SET的末尾追加元素时，才可以仅修改元数据，不重建整张表。否则需要使用COPY算法进行表重建。

PolarDB MySQL版8.0.2版本

PolarDB MySQL版8.0.1版本

PolarDB MySQL版5.7版本

PolarDB MySQL版5.6版本

PolarDB MySQL版8.0.2版本

PolarDB MySQL版8.0.1版本

PolarDB MySQL版5.7版本

PolarDB MySQL版5.6版本

PolarDB MySQL版5.6版本不支持Generated Column特性。

PolarDB MySQL版8.0.2版本

PolarDB MySQL版8.0.1版本

PolarDB MySQL版5.7版本

PolarDB MySQL版5.6版本

PolarDB MySQL版8.0.2版本

1. 引入分区级元数据锁MDL，将参数loose_partition_level_mdl_enabled的值设为true后，执行DDL操作时不影响不涉及的分区上的DML，详细信息请查看在线分区维护。

2. RANGE和LIST分区增加或删除分区时不需要重建表。HASH和KEY分区增加分区时需要重建表，HASH和KEY分区不支持删除分区操作。

3. 仅支持HASH和KEY分区。

4. 对InnoDB引擎中的表执行OPTIMIZE PARTITION操作时，会重建整张分区表。重建期间支持对目标表的读写操作。此时，您可以将参数innodb_parallel_build_primary_index的值设置为ON，使用并行DDL功能加快重建速度。

5. 秒级转换仅支持将普通表快速转换为RANGE分区表。

6. PolarDB MySQL版支持创建和删除分区粒度的索引，详情请参见部分索引（Partial Index）。

7. 重分布分区或重建分区只重建指定需要做数据重分布和重建的分区，其他分区不受影响。

8. 分析分区只修改统计信息，不修改表的元数据和数据。

9. 检查分区不修改元数据和数据。

10. 修复分区只重建指定需要修复的分区。

PolarDB MySQL版8.0.1版本

1. RANGE和LIST分区增加分区时不需要重建表。HASH和KEY分区增加分区时需要重建表。

2. HASH和KEY分区不支持删除分区操作。

3. 对InnoDB引擎中的表执行OPTIMIZE PARTITION操作时，会重建整张分区表。重建期间支持对目标表的读写操作。此时，您可以将参数innodb_parallel_build_primary_index的值设置为ON，使用并行DDL功能加快重建速度。

4. 重分布、重建和修复分区只重建指定需要重分布、重建和修复的分区， 不涉及其他分区。

5. 分析分区只修改统计信息，不修改表的元数据和数据。

6. 检查分区不修改元数据和数据。

PolarDB MySQL版5.7版本

1. RANGE和LIST分区增加或删除分区时不需要重建表。HASH和KEY分区增加分区时需要重建表，HASH和KEY分区不支持删除分区操作。

2. 重分布、重建和修复分区只重建指定需要重分布、重建和修复的分区， 不涉及其他分区。

3. 分析分区只修改统计信息，不修改表的元数据和数据。

4. 检查分区不修改元数据和数据。

PolarDB MySQL版5.6版本

1. RANGE和LIST分区增加或删除分区时不需要重建表。HASH和KEY分区增加分区时需要重建表，HASH和KEY分区不支持删除分区操作。

2. 重分布、重建和修复分区只重建指定需要重分布、重建和修复的分区， 不涉及其他分区。

3. 分析分区只修改统计信息，不修改表的元数据和数据。

4. 检查分区不修改元数据和数据。