mysql 5.6 中 explicit_defaults_for_timestamp参数
一:
官方文档中关于explicit_defaults_for_timestamp参数说明如下:
-
explicit_defaults_for_timestampIntroduced 5.6.6 Deprecated 5.6.6 Command-Line Format --explicit_defaults_for_timestamp=#System Variable Name explicit_defaults_for_timestampVariable Scope Global, Session Dynamic Variable No Permitted Values Type booleanDefault FALSEIn MySQL, the
TIMESTAMPdata type differs in nonstandard ways from other data types:(在没有设置explicit_defaults_for_timestamp=1的情况下)-
TIMESTAMPcolumns not explicitly declared with theNULLattribute are assigned theNOT NULLattribute. (Columns of other data types, if not explicitly declared asNOT NULL, permitNULLvalues.) Setting such a column toNULLsets it to the current timestamp.在默认情况下,如果TIMESTAMP列没有显示的指明null属性,那么该列会被自动加上not null属性(而其他类型的列如果没有被显示的指定not null,那么是允许null值的),如果往这个列中插入null值,会自动的设置该列的值为current timestamp值 -
The first
TIMESTAMPcolumn in a table, if not declared with theNULLattribute or an explicitDEFAULTorON UPDATEclause, is automatically assigned theDEFAULT CURRENT_TIMESTAMPandON UPDATE CURRENT_TIMESTAMPattributes.表中的第一个TIMESTAMP列,如果没有指定null属性或者没有指定默认值,也没有指定ON UPDATE语句。那么该列会自动被加上DEFAULT CURRENT_TIMESTAMP和ON UPDATE CURRENT_TIMESTAMP属性。 -
TIMESTAMPcolumns following the first one, if not declared with theNULLattribute or an explicitDEFAULTclause, are automatically assignedDEFAULT '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
TIMESTAMPbut 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_timestampsystem variable at server startup. With this variable enabled, the server handlesTIMESTAMPas follows instead:如果我们在启动的时候在配置文件中指定了explicit_defaults_for_timestamp=1,mysql会按照如下的方式处理TIMESTAMP 列-
TIMESTAMPcolumns not explicitly declared asNOT NULLpermitNULLvalues. Setting such a column toNULLsets it toNULL, not the current timestamp. 此时如果TIMESTAMP列没有显示的指定not null属性,那么默认的该列可以为null,此时向该列中插入null值时,会直接记录null,而不是current timestamp。 -
No
TIMESTAMPcolumn is assigned theDEFAULT CURRENT_TIMESTAMPorON UPDATE CURRENT_TIMESTAMPattributes automatically. Those attributes must be explicitly specified. 不会自动的为表中的第一个TIMESTAMP列加上DEFAULT CURRENT_TIMESTAMP和ON UPDATE CURRENT_TIMESTAMP属性,除非你在建表的时候显示的指明 -
TIMESTAMPcolumns declared asNOT NULLand without an explicitDEFAULTclause 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 asDATETIME.如果TIMESTAMP列被加上了not null属性,并且没有指定默认值。这时如果向表中插入记录,但是没有给该TIMESTAMP列指定值的时候,如果strict sql_mode被指定了,那么会直接报错。如果strict sql_mode没有被指定,那么会向该列中插入'0000-00-00 00:00:00'并且产生一个warning
Noteexplicit_defaults_for_timestampis itself deprecated because its only purpose is to permit control over now-deprecatedTIMESTAMPbehaviors that will be removed in a future MySQL release. When that removal occurs,explicit_defaults_for_timestampwill have no purpose and will be removed as well.This variable was added in MySQL 5.6.6
-
- [Warning] TIMESTAMP with implicit DEFAULT value is deprecated. Please use --explicit_defaults_for_timestamp server option (see documentation for more details).
time1 timestamp,
time2 timestamp,
time3 timestamp,
id int
);
- 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=utf8 |
- mysql> insert into test_time select null,null,null,1;
- Query OK, 1 row affected (0.02 sec)
- Records: 1 Duplicates: 0 Warnings: 0
- mysql> select * from test_time;
- +---------------------+---------------------+---------------------+------+
- | time1 | time2 | time3 | id |
- +---------------------+---------------------+---------------------+------+
- | 2016-01-25 09:55:36 | 2016-01-25 09:55:36 | 2016-01-25 09:55:36 | 1 |
- +---------------------+---------------------+---------------------+------+##往timestamp列插入null值时,会自动为该列设置为current time
- 1 row in set (0.00 sec)
- mysql> insert into test_time(time1,id) select null,2;
- Query OK, 1 row affected (0.04 sec)
- Records: 1 Duplicates: 0 Warnings: 0
- mysql> select * from test_time;
- +---------------------+---------------------+---------------------+------+
- | time1 | time2 | time3 | id |
- +---------------------+---------------------+---------------------+------+
- | 2016-01-25 09:55:36 | 2016-01-25 09:55:36 | 2016-01-25 09:55:36 | 1 |
- | 2016-01-25 10:00:00 | 0000-00-00 00:00:00 | 0000-00-00 00:00:00 | 2 |
- +---------------------+---------------------+---------------------+------+##插入时未指定值的timestamp列中被插入了0000-00-00 00:00:00(非表中第一个timestamp列)
- 2 rows in set (0.00 sec)
- 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 |
- +---------------------+---------------------+---------------------+------+
- | 2016-01-25 09:55:36 | 2016-01-25 09:55:36 | 2016-01-25 09:55:36 | 1 |
- | 2016-01-25 10:00:00 | 0000-00-00 00:00:00 | 0000-00-00 00:00:00 | 2 |
- | 2016-01-25 10:01:41 | 0000-00-00 00:00:00 | 0000-00-00 00:00:00 | 3 |
- +---------------------+---------------------+---------------------+------+##插入时未指定值的第一个timestamp列中被插入了current time值
- 3 rows in set (0.00 sec)
2.启动mysql时设置explicit_defaults_for_timestamp=1
time1 timestamp,
time2 timestamp,
time3 timestamp,
id int
);
- 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=utf8 |
- mysql> insert into test_time1 select null,null,null,1;
- Query OK, 1 row affected (0.00 sec)
- Records: 1 Duplicates: 0 Warnings: 0
- mysql> select * from test_time1;
- +-------+-------+-------+------+
- | time1 | time2 | time3 | id |
- +-------+-------+-------+------+
- | NULL | NULL | 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 | NULL | 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 | NULL | 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列插入测试
- <span style="color:#555555;">mysql> 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 </span><span style="color:#ff0000;">##为timestamp列指定了not null属性,在stric sql_mode时,如果插入时该列没有指定值,会直接报错</span><span style="color:#555555;">
- 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 </span><span style="color:#ff0000;">##如果为timestamp列指定not null属性,在非stric sql_mode模式下,如果插入的时候该列没有指定值,那么会向该列中插入0000-00-00 00:00:00,并且产生告警</span><span style="color:#555555;">
- 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)</span>