文档中心

背景

MySQL中有这样的一个默认行为：一行数据中的某些列被更新了，如果这一行中有timestamp类型的列，那么这个timestamp列会自动更新时间戳。这个行为是由explicit_defaults_for_timestamp参数控制的。在实际使用过程中经常会遇到一些非预期的异常情况，这给数据库使用过程带来诸多不便，本文重点介绍参数explicit_defaults_for_timestamp使用过程中的常见问题和注意事项。

问题现象

• 问题1：从MySQL5.5版本升级到MySQL5.6版本后，为什么同样的建表语句，但是创建成功后显示的表结构信息变了
• 问题2：从MySQL5.5版本升级到MySQL5.6版本后，timestamp字段不能自动更新时间戳了
• 问题3：从MySQL5.5版本升级到MySQL5.6版本后，为什么插入timestamp字段，之前是显示当前时间戳，现在变成了'0000-00-00 00:00:00'
• 问题4：一张表中同时存在多个timestamp字段，字段默认值的显示结果不一样

原因分析

造成以上问题的根本原因是explicit_defaults_for_timestamp参数。该参数是在MySQL5.6.6版本被引入的，更早之前版本的行为等价于取值OFF。在5.6、5.7系列版本的默认值都是OFF，从MySQL8.0.2版本开始，默认值是ON。该参数类型是布尔型，取值含义说明如下：

• ON：关闭timestamp default的特性，不会自动更新时间戳，除非表结构定义时显式的指定；
• OFF：开启timestamp default的特性，会自动更新时间戳，会在建表时自动给timestamp字段类型的表结构定义添加如下内容：DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP

解决方案

在版本升级和数据迁移过程中，对于存在timestamp字段的数据，需要对齐explicit_defaults_for_timestamp参数的取值，确保timestamp时间戳的显示结果符合业务的期望要求。

案例复现

案例1：使用同样SQL建表后表结构的差异

表结构定义如下：

CREATE TABLE tb_01(
   x int(11) NOT NULL,
   y timestamp NOT NULL,
   PRIMARY KEY (x)
) ENGINE=InnoDB;

设置explicit_defaults_for_timestamp不同取值，观察创建后的表结构差异：

案例2：插入数据观察timestamp字段是否自动更新

插入数据：

insert into tb_01(x) values(1);
insert into tb_01(x) values(2);
insert into tb_01(x) values(3);

设置explicit_defaults_for_timestamp不同取值，观察数据插入后的差异

取值ON	取值OFF

说明：取值ON的情况下，插入数据可能会报错如下，原因是由于当前实例的sql_mode设置了NO_ZERO_IN_DATE和NO_ZERO_DATE，修改sql_mode为宽松模式，即可插入成功，但是会产生warning信息。

ERROR 1364 (HY000): Field 'y' doesn't have a default value

案例3：timestamp字段插入NULL值的结果差异

插入数据：

insert ignore into tb_01 values(1,NULL);

取值ON	取值OFF

说明：取值为ON时直接insert into会报错如下：

ERROR 1048 (23000): Column 'y' cannot be null

需要加上ignore关键字，这样可以插入成功，但是会报如下warning信息： 

案例4：单表含多个timestamp字段

设置参数explicit_defaults_for_timestamp=OFF，创建表：

CREATE TABLE tb_02(
   x int(11) NOT NULL AUTO_INCREMENT,
   y timestamp NOT NULL,
   z timestamp NOT NULL,
   w timestamp NOT NULL,
   PRIMARY KEY (x)
) ENGINE=InnoDB;

显示结果如下： 

说明：多个timestamp类型字段同时存在的情况下，仅对一个字段的默认值是随时间戳更新的，其他的默认值都是'0000-00-00 00:00:00'。

结论建议

结论

• 如果要利用timestamp字段自动更新时间戳，需要在创建表结构前设置explicit_defaults_for_timestamp=OFF，然后创建表后会自动给timestamp字段添加定义：DEFAULT CURRENT_TIMESTAMP ON UPDATE
• 如果表已经创建完成，需要执行ALTER TABLE命令，显式的给timestamp字段添加自动更新的表定义，例如：

ALTER TABLE tb_02 modify column  w  timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP;

建议

1. 数据迁移前，需要确保参数explicit_defaults_for_timestamp在源库和目标库的取值是一致的
2. 创建表时，建议显式的指定timestamp字段是否自动更新时间戳，规避使用隐式默认值的兼容性风险，例如：

CREATE TABLE tb_01 (
  x int(11) NOT NULL AUTO_INCREMENT,
  y timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  z timestamp NOT NULL DEFAULT '0000-00-00 00:00:00',
  PRIMARY KEY (x)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

1. 建议由应用程序来控制给数据打时间戳，避免版本升级过程带来的timestamp字段行为差异的影响。