MySQL数据库explicit_defaults_for_timestamp参数使用详解

MySQL中有这样的一个默认行为:一行数据中的某些列被更新了,如果这一行中有timestamp类型的列,那么这个timestamp列会自动更新时间戳。这个行为是由explicit_defaults__timestamp参数控制的。在实际使用过程中经常会遇到一些非预期的异常情况,这给数据库使用过程带来诸多不便,本文重点介绍参数explicit_defaults__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__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__timestamp参数的取值,确保timestamp时间戳的显示结果符合业务的期望要求。

案例复现

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

表结构定义如下:

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

设置explicit_defaults__timestamp不同取值,观察创建后的表结构差异:

取值ON取值OFFCREATE TABLE tb_01 (
x int(11) NOT NULL,
y timestamp NOT NULL,
PRIMARY KEY (x)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;CREATE TABLE tb_01 (
x int(11) NOT NULL,
y timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
PRIMARY KEY (x)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
案例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__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__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__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__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字段行为差异的影响。