explicit_defaults_for_timestamp参数使用详解
背景
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不同取值,观察创建后的表结构差异:
取值ON | 取值OFF |
---|---|
CREATE 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_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;
建议
- 数据迁移前,需要确保参数explicit_defaults_for_timestamp在源库和目标库的取值是一致的。
- 创建表时,建议显式的指定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;
- 建议由应用程序来控制给数据打时间戳,避免版本升级过程带来的timestamp字段行为差异的影响。