1.问题描述
这里我们说的日期为零值是指年、月、日为零,即'0000-00-00'。显然,这是不合法的日期值,但由于设计问题或历史遗留问题,有时候数据库中有类似日期值为零的数据,默认情况下插入零值日期会报错,可以通过修改参数sql_mode模式来避免该问题。下面展示下默认情况下插入零值的情况:
# 首先创建测试表 CREATE TABLE `t_zerodate` ( `increment_id` int unsigned NOT NULL AUTO_INCREMENT COMMENT '自增主键', `year_col` year DEFAULT NULL COMMENT '年', `date_col` date DEFAULT NULL COMMENT '日期', `dt_col` datetime DEFAULT NULL COMMENT 'datetime时间', `ts_col` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'timestamp时间', PRIMARY KEY (`increment_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='zerodate'; # 查看sql_mode模式 mysql> select @@sql_mode; +----------------------------------------------------------------------------------------------------+ | @@sql_mode | +----------------------------------------------------------------------------------------------------+ | STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION | +----------------------------------------------------------------------------------------------------+ # 分别插入年、月、日为零值测试 # 年份为0000 插入成功 mysql> insert into t_zerodate (year_col) values (0000); Query OK, 1 row affected (0.02 sec) # 月、日都不为零时 可插入成功 mysql> insert into t_zerodate (date_col) values ('0000-00-00'); ERROR 1292 (22007): Incorrect date value: '0000-00-00' for column 'date_col' at row 1 mysql> insert into t_zerodate (date_col) values ('0000-01-00'); ERROR 1292 (22007): Incorrect date value: '0000-01-00' for column 'date_col' at row 1 mysql> insert into t_zerodate (date_col) values ('0000-00-01'); ERROR 1292 (22007): Incorrect date value: '0000-00-01' for column 'date_col' at row 1 mysql> insert into t_zerodate (date_col) values ('0000-01-01'); Query OK, 1 row affected (0.02 sec)
2.sql_mode变更测试
关于sql_mode,原来写过一篇文章,sql_mode支持多个变量的不同组合,不同的sql_mode影响服务端支持的SQL语法以及数据校验规则。其中 NO_ZERO_IN_DATE
、NO_ZERO_DATE
这两个变量影响MySQL对日期零值的处理。上面测试中可以发现,严格模式下,当sql_mode中包含NO_ZERO_IN_DATE,NO_ZERO_DATE两个变量时,月和日都不为零时可以插入成功。
乍一看,NO_ZERO_IN_DATE和NO_ZERO_DATE两个变量很相似,但作用有什么不同呢?下面我们给出这两个变量的作用并做下具体测试。
NO_ZERO_DATE
模式影响服务端是否允许将 '0000-00-00' 作为有效日期。其效果还取决于sql_mode是否启用了严格模式。
- 如果未启用此模式,'0000-00-00'则允许插入并且不会产生警告。
- 如果只启用此模式,'0000-00-00'则允许插入但是会产生警告。
- 如果启用了此模式和严格模式,'0000-00-00'则会被认定为非法,并且插入也会产生错误。除非同时带有IGNORE,对于 INSERT IGNORE和UPDATE IGNORE,'0000-00-00'则允许插入但是会产生警告。
NO_ZERO_IN_DATE
模式影响服务端是否允许插入年份部分非零但月或日部分为0的日期。(例如'2010-00-01'或 '2010-01-00',但不影响日期'0000-00-00'),其效果同样还取决于sql_mode是否启用了严格模式。
- 如果未启用此模式,则允许部分为零的日期插入,并且不会产生任何警告。
- 如果只启用此模式,则将该零值日期插入为'0000-00-00'并产生警告。
- 如果启用了此模式和严格模式,则除非IGNORE同时指定,否则不允许插入为零的日期。对于INSERT IGNORE和 UPDATE IGNORE,将该零值日期插入为'0000-00-00'并产生警告。
同时,官方文档中指出:NO_ZERO_DATE和NO_ZERO_IN_DATE虽然不是严格模式的一部分,但应与严格模式结合使用,如果在未启用严格模式的情况下启用了NO_ZERO_DATE或NO_ZERO_IN_DATE则会产生警告,反之亦然,(sql_mode中包含STRICT_TRANS_TABLES,一般可认为启用了严格模式)。
下面我们来测试下,严格模式下分别启用和不启用这两个变量的效果:
1.严格模式下 同时启用NO_ZERO_DATE、NO_ZERO_IN_DATE # 上文已经测试过,正常情况下 月、日都不为零时 可插入成功 # 下面测试insert ignore into mysql> set session sql_mode = "STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION"; Query OK, 0 rows affected (0.00 sec) mysql> truncate table t_zerodate; Query OK, 0 rows affected (0.07 sec) mysql> insert ignore into t_zerodate (date_col) values ('0000-00-00'); Query OK, 1 row affected, 1 warning (0.01 sec) mysql> insert ignore into t_zerodate (date_col) values ('2010-00-00'); Query OK, 1 row affected, 1 warning (0.01 sec) mysql> insert ignore into t_zerodate (date_col) values ('2010-01-00'); Query OK, 1 row affected, 1 warning (0.01 sec) mysql> insert ignore into t_zerodate (date_col) values ('2010-00-01'); Query OK, 1 row affected, 1 warning (0.01 sec) mysql> select date_col from t_zerodate; +------------+ | date_col | +------------+ | 0000-00-00 | | 0000-00-00 | | 0000-00-00 | | 0000-00-00 | +------------+ # 结论: 正常情况下 月、日都不为零时 可插入成功; 对于INSERT IGNORE则允许插入,但会产生告警,并会将零值日期保存为'0000-00-00'。 2.严格模式下 不启用NO_ZERO_DATE mysql> set session sql_mode = "STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION"; Query OK, 0 rows affected, 1 warning (0.00 sec) mysql> truncate table t_zerodate; Query OK, 0 rows affected (0.08 sec) mysql> insert into t_zerodate (date_col) values ('0000-00-00'); Query OK, 1 row affected (0.01 sec) mysql> insert into t_zerodate (date_col) values ('2010-00-01'); ERROR 1292 (22007): Incorrect date value: '2010-00-01' for column 'date_col' at row 1 mysql> insert into t_zerodate (date_col) values ('2010-01-00'); ERROR 1292 (22007): Incorrect date value: '2010-01-00' for column 'date_col' at row 1 mysql> insert into t_zerodate (date_col) values ('0000-00-01'); ERROR 1292 (22007): Incorrect date value: '0000-00-01' for column 'date_col' at row 1 mysql> insert into t_zerodate (date_col) values ('0000-01-00'); ERROR 1292 (22007): Incorrect date value: '0000-01-00' for column 'date_col' at row 1 # 结论: '0000-00-00'可以正常插入,其余月、日为零的日期插入会报错; 对于INSERT IGNORE则允许插入,但会产生告警,并会将零值日期保存为'0000-00-00'。 3.严格模式下 不启用NO_ZERO_IN_DATE mysql> set session sql_mode = "STRICT_TRANS_TABLES,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION"; Query OK, 0 rows affected, 1 warning (0.00 sec) mysql> truncate table t_zerodate; Query OK, 0 rows affected (0.07 sec) mysql> insert into t_zerodate (date_col) values ('0000-00-00'); ERROR 1292 (22007): Incorrect date value: '0000-00-00' for column 'date_col' at row 1 mysql> insert into t_zerodate (date_col) values ('2010-00-00'); Query OK, 1 row affected (0.01 sec) mysql> insert into t_zerodate (date_col) values ('2010-00-01'); Query OK, 1 row affected (0.00 sec) mysql> insert into t_zerodate (date_col) values ('2010-01-00'); Query OK, 1 row affected (0.00 sec) mysql> insert ignore into t_zerodate (date_col) values ('0000-00-00'); Query OK, 1 row affected, 1 warning (0.01 sec) mysql> select date_col from t_zerodate; +------------+ | date_col | +------------+ | 2010-00-00 | | 2010-00-01 | | 2010-01-00 | | 0000-00-00 | +------------+ # 结论: '0000-00-00'插入报错,其余月、日为零的日期可以正常插入; 对于INSERT IGNORE则允许插入'0000-00-00',但会产生告警。 4.严格模式下 NO_ZERO_DATE和NO_ZERO_IN_DATE都不启用 mysql> set session sql_mode = "STRICT_TRANS_TABLES,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION"; Query OK, 0 rows affected, 1 warning (0.00 sec) mysql> truncate table t_zerodate; Query OK, 0 rows affected (0.09 sec) mysql> insert into t_zerodate (date_col) values ('0000-00-00'); Query OK, 1 row affected (0.01 sec) mysql> insert into t_zerodate (date_col) values ('2010-00-00'); Query OK, 1 row affected (0.01 sec) mysql> insert into t_zerodate (date_col) values ('2010-00-01'); Query OK, 1 row affected (0.01 sec) mysql> insert into t_zerodate (date_col) values ('2010-01-00'); Query OK, 1 row affected (0.01 sec) # 结论: '0000-00-00'和其余月、日为零的日期都可以正常插入。
3.结论及建议
简单总结下,NO_ZERO_DATE模式影响'0000-00-00'日期的插入,NO_ZERO_IN_DATE模式影响除'0000-00-00'外的月、日为零的日期的插入。另外无论何种模式,YEAR类型都允许0000插入,这两个变量影响的是DATE、DATETIME、TIMESTAMP三种字段类型中对日期部分为零的处理。
至于我们是否要启用这两种模式,这取决于业务需求。如果你的业务有插入零值日期的需求,则可以选择sql_mode中不要包含NO_ZERO_DATE和NO_ZERO_IN_DATE,例如,某字段要求设置为DATE类型且不为空,默认值设为'0000-00-00'。一般情况下,NO_ZERO_DATE和NO_ZERO_IN_DATE建议同时有或者同时没有,有插入零日期值的需求则可以去除二者,没有此类需要则可以保留二者。这里提醒下,官方文档中讲到,这两个变量在未来版本中不再作为独立变量使用,故官方不推荐使用。
总结:
写了这么多,不知道你认真看了多少,其实本篇文章讲的东西还是比较简单的。如果你遇到过此类问题,再看下本篇文章可能理解会更深刻些,没遇过此类问题的小伙伴,希望这篇文章可以让你知道MySQL对于零值日期有不同的处理。