秒级加字段

前提条件

使用限制

• 新增列只能为表的最后一列。

• 不支持添加虚拟列（PolarDB MySQL版8.0版本支持）。

• PolarDB MySQL版5.6版本不支持分区表秒级添加字段。PolarDB MySQL版5.7版本和PolarDB MySQL版8.0版本支持分区表秒级添加字段。

  说明

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

• 不支持使用了全文索引或列存索引的表。

• 不支持开启了Implicit primary key选项且未自定义主键的表。

• 不支持在同一条SQL中同时执行其它DDL操作和Instant add column操作。

使用方法

• 参数设置

  针对PolarDB MySQL版5.6版本和PolarDB MySQL版5.7版本的集群，您需要开启loose_innodb_support_instant_add_column参数来使用秒级加字段功能。如何设置参数值请参见设置集群参数和节点参数。

  说明

  PolarDB MySQL版8.0版本的集群无需配置该参数即可直接使用秒级加字段功能。

  参数	级别	说明
  loose_innodb_support_instant_add_column	Global	秒级加字段功能的开关，取值范围如下： ON：开启秒级加字段功能。 OFF（默认）：关闭秒级加字段功能。

• 语句

  • 指定ALGORITHM=INSTANT以强制使用秒级加字段功能，语句示例如下：

    ALTER TABLE test.t ADD COLUMN test_column int, ALGORITHM=INSTANT;

    使用上述语句时，若返回ERROR 0A000: ALGORITHM=INSTANT is not supported for this operation. Try ALGORITHM=COPY/INPLACE. 的错误，表示当前加列操作不能以Instant算法执行，建议您查看loose_innodb_support_instant_add_column参数是否已开启，并仔细核对使用限制。

  • 不指定ALGORITHM或指定ALGORITHM=DEFAULT，PolarDB会自行选择执行速度最快的算法来执行加列操作，语句示例如下：

    ALTER TABLE test.t ADD COLUMN test_column int, ALGORITHM=DEFAULT;
    ALTER TABLE test.t ADD COLUMN test_column int;

    说明

    PolarDB算法选择的优先级为INSTANT > INPLACE > COPY。

• 查看通过Instant算法增加的列信息

  对于PolarDB MySQL版5.6版本和PolarDB MySQL版5.7版本，INFORMATION_SCHEMA数据库中新增了INNODB_SYS_INSTANT_COLUMNS表。该表记录了使用Instant算法增加的列信息，例如列名、列序号和默认值（二进制方式存储）等。您可通过如下语句查看该表详情来确认新增的列信息。

  SELECT * FROM INFORMATION_SCHEMA.INNODB_SYS_INSTANT_COLUMNS;

  说明

  对目标表使用了Instant算法增加列后，如果执行了需要重建表的DDL操作（如DROP COLUMN），系统将会删除INNODB_SYS_INSTANT_COLUMNS表中目标表的相关列信息。

  对于PolarDB MySQL版8.0版本，您可通过如下语句查看表的列信息，若查询结果中has_default列为1，则说明该列是通过Instant算法增加的。

  SELECT * FROM INFORMATION_SCHEMA.INNODB_COLUMNS WHERE TABLE_ID = (SELECT TABLE_ID FROM INFORMATION_SCHEMA.INNODB_TABLES WHERE NAME = "test/t1");

相关视频

联系我们

若您对DDL操作有任何疑问，可通过钉钉搜索群号入群咨询。您可以直接@群内专家，并附上您要咨询的问题；同时群内也有PolarDB MySQL版小助手24*7小时在线回答您的问题。钉钉群号：1537504****。