mysql 5.6 中 explicit_defaults_for_timestamp参数

Posted 2022-06-22 渔夫数据库笔记

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了mysql 5.6 中 explicit_defaults_for_timestamp参数相关的知识，希望对你有一定的参考价值。

一：

官方文档中关于explicit_defaults_for_timestamp参数说明如下：

explicit_defaults_for_timestamp

Introduced	5.6.6
Deprecated	5.6.6
Command-Line Format	`--explicit_defaults_for_timestamp=#`
System Variable	Name	`explicit_defaults_for_timestamp`
	Variable Scope	Global, Session
	Dynamic Variable	No
Permitted Values	Type	`boolean`
	Default	`FALSE`

In mysql, the TIMESTAMP data type differs in nonstandard ways from other data types: mysql中TIMESTAMP类型和其他的类型有点不一样(在没有设置explicit_defaults_for_timestamp=1的情况下）

TIMESTAMP columns not explicitly declared with the NULL attribute are assigned the NOT NULL attribute. (Columns of other data types, if not explicitly declared as NOT NULL, permit NULL values.) Setting such a column to NULL sets it to the current timestamp.在默认情况下，如果TIMESTAMP列没有显式的指明null属性，那么该列会被自动加上not null属性(而其他类型的列如果没有被显式的指定not null，那么是允许null值的)，如果往这个列中插入null值，会自动的设置该列的值为current timestamp值
The first TIMESTAMP column in a table, if not declared with the NULL attribute or an explicit DEFAULT or ON UPDATE clause, is automatically assigned the DEFAULT CURRENT_TIMESTAMP and ON UPDATE CURRENT_TIMESTAMP attributes.表中的第一个TIMESTAMP列，如果没有指定null属性或者没有指定默认值，也没有指定ON UPDATE语句。那么该列会自动被加上DEFAULT CURRENT_TIMESTAMP和ON UPDATE CURRENT_TIMESTAMP属性。
TIMESTAMP columns following the first one, if not declared with the NULL attribute or an explicit DEFAULT clause, are automatically assigned DEFAULT '0000-00-00 00:00:00' (the “zero” timestamp). For inserted rows that specify no explicit value for such a column, the column is assigned '0000-00-00 00:00:00' and no warning occurs.第一个TIMESTAMP列之后的其他的TIMESTAMP类型的列，如果没有指定null属性，也没有指定默认值，那么该列会被自动加上DEFAULT '0000-00-00 00:00:00'属性。如果insert语句中没有为该列指定值，那么该列中插入'0000-00-00 00:00:00'，并且没有warning

Those nonstandard behaviors remain the default for TIMESTAMP but as of MySQL 5.6.6 are deprecated and this warning appears at startup:在5.6.6及以后的版本中，如果在配置文件中没有指定explicit_defaults_for_timestamp参数，启动时error日志中会报如下错误

[Warning] TIMESTAMP with implicit DEFAULT value is deprecated.
Please use --explicit_defaults_for_timestamp server option (see
documentation for more details).

As indicated by the warning, to turn off the nonstandard behaviors, enable the explicit_defaults_for_timestamp system variable at server startup. With this variable enabled, the server handles TIMESTAMP as follows instead:如果我们在启动的时候在配置文件中指定了explicit_defaults_for_timestamp=1，mysql会按照如下的方式处理TIMESTAMP 列

TIMESTAMP columns not explicitly declared as NOT NULL permit NULL values. Setting such a column to NULL sets it to NULL, not the current timestamp. 此时如果TIMESTAMP列没有显式的指定not null属性，那么默认的该列可以为null，此时向该列中插入null值时，会直接记录null，而不是current timestamp。
No TIMESTAMP column is assigned the DEFAULT CURRENT_TIMESTAMP or ON UPDATE CURRENT_TIMESTAMP attributes automatically. Those attributes must be explicitly specified. 不会自动的为表中的第一个TIMESTAMP列加上DEFAULT CURRENT_TIMESTAMP 和ON UPDATE CURRENT_TIMESTAMP属性，除非你在建表的时候显式的指明
TIMESTAMP columns declared as NOT NULL and without an explicit DEFAULT clause are treated as having no default value. For inserted rows that specify no explicit value for such a column, the result depends on the SQL mode. If strict SQL mode is enabled, an error occurs. If strict SQL mode is not enabled, the column is assigned the implicit default of '0000-00-00 00:00:00' and a warning occurs. This is similar to how MySQL treats other temporal types such as DATETIME.如果TIMESTAMP列被加上了not null属性，并且没有指定默认值。这时如果向表中插入记录，但是没有给该TIMESTAMP列指定值的时候，如果strict sql_mode被指定了，那么会直接报错。如果strict sql_mode没有被指定，那么会向该列中插入'0000-00-00 00:00:00'并且产生一个warning

Note

explicit_defaults_for_timestamp is itself deprecated because its only purpose is to permit control over now-deprecated TIMESTAMP behaviors that will be removed in a future MySQL release. When that removal occurs,explicit_defaults_for_timestamp will have no purpose and will be removed as well. >>explicit_defaults_for_timestamp参数主要用来控制TIMESTAMP数据类型跟其他数据类型不一致的特性，但是TIMESTAMP的这个特性在将来会被废弃，所以explicit_defaults_for_timestamp参数也会在将来被废弃

This variable was added in MySQL 5.6.6

二：测试 1.explicit_defaults_for_timestamp=0 1)查看errorlog

[Warning] TIMESTAMP with implicit DEFAULT value is deprecated. Please use --explicit_defaults_for_timestamp server option (see documentation for more details).

2)创建测试表test_time create table test_time(
time1 timestamp,
time2 timestamp,
time3 timestamp,
id int
); ##创建表的时候，没有显示的指定三个timestamp列的not null属性，也没有为三个列指定默认值 3)查看表结构

 show create table test_time;
+-----------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Table     | Create Table                                                                                                                                                                                                                                                                                               |
+-----------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| test_time | CREATE TABLE `test_time` (
  `time1` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  `time2` timestamp NOT NULL DEFAULT '0000-00-00 00:00:00',
  `time3` timestamp NOT NULL DEFAULT '0000-00-00 00:00:00',
  `id` int(11) DEFAULT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 |

##从表结构中可以看到表中三个timestamp列都被自动设置为not null，并且表中第一个timestamp列被设置了DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP默认值，其他的timestamp列被加上了DEFAULT '0000-00-00 00:00:00'默认值 3.插入测试 insert into test_time select null,'',null,1;

mysql> insert into test_time select null,'',null,1;
Query OK, 1 row affected, 1 warning (0.00 sec)
Records: 1  Duplicates: 0  Warnings: 1
##需要去掉 sql_mode 中的 STRICT_TRANS_TABLES 限制，否则上面的语句会报如下错误
ERROR 1292 (22007): Incorrect datetime value: '' for column 'time2' at row 1


mysql> select * from test_time;
+---------------------+---------------------+---------------------+------+
| time1               | time2               | time3               | id   |
+---------------------+---------------------+---------------------+------+
| 2019-12-23 17:33:33 | 0000-00-00 00:00:00 | 2019-12-23 17:33:33 |    1 |
+---------------------+---------------------+---------------------+------+
##往timestamp列插入null值时，会自动为该列设置为current time，往timestamp列插入空值，会设置为该列默认值


mysql> insert into test_time(time1,id) select null,2;
Query OK, 1 row affected (0.00 sec)
Records: 1  Duplicates: 0  Warnings: 0

mysql> select * from test_time;
+---------------------+---------------------+---------------------+------+
| time1               | time2               | time3               | id   |
+---------------------+---------------------+---------------------+------+
| 2019-12-23 17:33:33 | 0000-00-00 00:00:00 | 2019-12-23 17:33:33 |    1 |
| 2019-12-23 17:37:46 | 0000-00-00 00:00:00 | 0000-00-00 00:00:00 |    2 |
+---------------------+---------------------+---------------------+------+
##插入时未指定值的timestamp列中被插入了0000-00-00 00:00:00(非表中第一个timestamp列)


mysql> insert into test_time(id) select 3;
Query OK, 1 row affected (0.03 sec)
Records: 1  Duplicates: 0  Warnings: 0

mysql> select * from test_time;
+---------------------+---------------------+---------------------+------+
| time1               | time2               | time3               | id   |
+---------------------+---------------------+---------------------+------+
| 2019-12-23 17:33:33 | 0000-00-00 00:00:00 | 2019-12-23 17:33:33 |    1 |
| 2019-12-23 17:37:46 | 0000-00-00 00:00:00 | 0000-00-00 00:00:00 |    2 |
| 2019-12-23 17:39:01 | 0000-00-00 00:00:00 | 0000-00-00 00:00:00 |    3 |
+---------------------+---------------------+---------------------+------+
##插入时未指定值的第一个timestamp列中被插入了current time值

2. explicit_defaults_for_timestamp=1 1)建表 create table test_time1(
time1 timestamp,
time2 timestamp,
time3 timestamp,
id int
); ##建表时没有为timestamp列指定null属性，也没有为其指定默认值 2) 查看表结构

show create table test_time1;
+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Table      | Create Table                                                                                                                                                                                                         |
+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| test_time1 | CREATE TABLE `test_time1` (
  `time1` timestamp NULL DEFAULT NULL,
  `time2` timestamp NULL DEFAULT NULL,
  `time3` timestamp NULL DEFAULT NULL,
  `id` int(11) DEFAULT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4

##通过表结构我们看到，三个timestamp列都被设置为null，并且设置了默认值为null 3)插入测试

mysql> insert into test_time1 select null,'',null,1;
Query OK, 1 row affected, 1 warning (0.00 sec)
Records: 1  Duplicates: 0  Warnings: 1

mysql> select * from test_time1;
+-------+---------------------+-------+------+
| time1 | time2               | time3 | id   |
+-------+---------------------+-------+------+
| NULL  | 0000-00-00 00:00:00 | NULL  |    1 |
+-------+---------------------+-------+------+
##未显示指定timestamp列为not null时，能够向timestamp列中插入null值
1 row in set (0.00 sec)

mysql> insert into test_time1(time1,id) select null,2;
Query OK, 1 row affected (0.01 sec)
Records: 1  Duplicates: 0  Warnings: 0

mysql> commit;
Query OK, 0 rows affected (0.00 sec)

mysql> select * from test_time1;
+-------+---------------------+-------+------+
| time1 | time2               | time3 | id   |
+-------+---------------------+-------+------+
| NULL  | 0000-00-00 00:00:00 | NULL  |    1 |
| NULL  | NULL                | NULL  |    2 |
+-------+---------------------+-------+------+
##插入时没有为timestamp列指定值时，自动插入null值
2 rows in set (0.00 sec)

mysql> insert into test_time1(id) select 3;
Query OK, 1 row affected (0.02 sec)
Records: 1  Duplicates: 0  Warnings: 0

mysql> select * from test_time1;
+-------+---------------------+-------+------+
| time1 | time2               | time3 | id   |
+-------+---------------------+-------+------+
| NULL  | 0000-00-00 00:00:00 | NULL  |    1 |
| NULL  | NULL                | NULL  |    2 |
| NULL  | NULL                | NULL  |    3 |
+-------+---------------------+-------+------+
##插入时没有为timestamp指定值时，自动插入null值(表中第一个timestamp列也是插入null值)
3 rows in set (0.00 sec)

4)指定了not null属性的timestamp列插入测试

create table test_time2(
    -> time1 timestamp,
    -> time2 timestamp not null,
    -> time3 timestamp,
    -> id int
    -> );
Query OK, 0 rows affected (0.10 sec)

mysql> insert into test_time2(time1,id) select null,1;
ERROR 1364 (HY000): Field 'time2' doesn't have a default value ##为timestamp列指定了not null属性，在stric sql_mode时，如果插入时该列没有指定值，会直接报错
mysql> show variables like 'sql_mode';
+---------------+--------------------------------------------------------------------------------------+
| Variable_name | Value                                                                                |
+---------------+--------------------------------------------------------------------------------------+
| sql_mode      | NO_AUTO_VALUE_ON_ZERO,STRICT_TRANS_TABLES,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION |
+---------------+--------------------------------------------------------------------------------------+
1 row in set (0.01 sec)


mysql> set session sql_mode='';
Query OK, 0 rows affected (0.00 sec)

mysql> show variables like 'sql_mode';
+---------------+-------+
| Variable_name | Value |
+---------------+-------+
| sql_mode      |       |
+---------------+-------+
1 row in set (0.00 sec)

mysql> insert into test_time2(time1,id) select null,1;
Query OK, 1 row affected, 1 warning (0.01 sec)
Records: 1  Duplicates: 0  Warnings: 1 ##如果为timestamp列指定not null属性，在非stric sql_mode模式下，如果插入的时候该列没有指定值，那么会向该列中插入0000-00-00 00:00:00，并且产生告警

mysql> show warnings;
+---------+------+--------------------------------------------+
| Level   | Code | Message                                    |
+---------+------+--------------------------------------------+
| Warning | 1364 | Field 'time2' doesn't have a default value |
+---------+------+--------------------------------------------+
1 row in set (0.00 sec)

mysql> select * from test_time2;
+-------+---------------------+-------+------+
| time1 | time2               | time3 | id   |
+-------+---------------------+-------+------+
| NULL  | 0000-00-00 00:00:00 | NULL  |    1 |
+-------+---------------------+-------+------+
1 row in set (0.00 sec)

以上是关于mysql 5.6 中 explicit_defaults_for_timestamp参数的主要内容，如果未能解决你的问题，请参考以下文章

如果包含 json 文档作为字符串，如何从 MySQL(5.6) 列中获取值

再见了MySQL 5.6

[MySQL 5.6] 初识5.6的optimizer trace

MySQL 5.6中的变量

MYSQL 5.6中禁用INNODB引擎

在mysql（5.6）数据库中存储json数组的数据类型[关闭]