【MySQL】explicit_defaults_for_timestamp 參數詳解
explicit_defaults_for_timestamp
系統變量決定MySQL服務端對timestamp列中的默認值和NULL
值的不同處理方法。此變量自MySQL 5.6.6 版本引入,分為全局級別和會話級別,可動態更新,默認值為OFF。本文主要介紹該參數打開和關閉情況下對timestamp的影響 。
1.explicit_defaults_for_timestamp = OFF
當該參數默認設置為OFF時,其行為如下:
- 在默認情況下,如果timestamp列沒有顯式的指明null屬性,那麽該列會被自動加上not null屬性(而其他類型的列如果沒有被顯式的指定not null,那麽是允許null值的),如果往這個列中插入null值,會自動的設置該列的值為current timestamp值。
- 表中的第一個timestamp列,如果沒有指定null屬性或者沒有指定默認值,也沒有指定ON UPDATE語句。那麽該列會自動被加上DEFAULT CURRENT_TIMESTAMP和ON UPDATE CURRENT_TIMESTAMP屬性。
- 對於其它TIMESTAMP列,如果沒有顯示指定NULL和DEFAULT屬性的話,會自動設置為NOT NULL DEFAULT ‘0000-00-00 00:00:00‘。(當然,這個與SQL_MODE有關,如果SQL_MODE中包含‘NO_ZERO_DATE‘,實際上是不允許將其默認值設置為‘0000-00-00 00:00:00‘的。)
下面我們來測試下:(本文操作基於MySQL5.7.23 版本 SQL_MODE不包含‘NO_ZERO_DATE‘)
mysql> show variables like ‘explicit_defaults_for_timestamp‘; +---------------------------------+-------+ | Variable_name | Value | +---------------------------------+-------+ | explicit_defaults_for_timestamp | OFF | +---------------------------------+-------+ mysql> create table t1 -> ( -> ts1 timestamp, -> ts2 timestamp, -> ts3 timestamp default ‘2010-01-01 00:00:00‘ -> ); Query OK, 0 rows affected (0.03 sec) mysql> show create table t1\G *************************** 1. row *************************** Table: t1 Create Table: CREATE TABLE `t1` ( `ts1` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, `ts2` timestamp NOT NULL DEFAULT ‘0000-00-00 00:00:00‘, `ts3` timestamp NOT NULL DEFAULT ‘2010-01-01 00:00:00‘ ) ENGINE=InnoDB DEFAULT CHARSET=utf8 1 row in set (0.00 sec) mysql> insert into t1 values (null,null,null); Query OK, 1 row affected (0.00 sec) mysql> select * from t1; +---------------------+---------------------+---------------------+ | ts1 | ts2 | ts3 | +---------------------+---------------------+---------------------+ | 2019-04-09 15:54:56 | 2019-04-09 15:54:56 | 2019-04-09 15:54:56 | +---------------------+---------------------+---------------------+ 1 row in set (0.00 sec)
從表結構來看,MySQL自動為第一個timestamp字段自動設置NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP屬性,而後面的timestamp字段,若沒有指定,則設置了 NOT NULL DEFAULT ‘0000-00-00 00:00:00‘屬性。如果向timestamp這個列中插入null值,系統會自動的設置該列的值為current timestamp值。即explicit_defaults_for_timestamp=OFF時,即使timestamp列設為NOT NULL也能插入NULL值,系統會自動將NULL值設為current timestamp。
2.explicit_defaults_for_timestamp = ON
當該參數設置為ON時,其行為如下:
- 如果timestamp列沒有顯式的指定not null屬性,那麽默認的該列可以為null,此時向該列中插入null值時,會直接記錄null,而不是current timestamp。
- 不會自動的為表中的第一個timestamp列加上DEFAULT CURRENT_TIMESTAMP 和ON UPDATE CURRENT_TIMESTAMP屬性。
- 如果timestamp列被加上了not null屬性,並且沒有指定默認值。這時如果向表中插入記錄,但是沒有給該TIMESTAMP列指定值的時候,如果strict sql_mode被指定了,那麽會直接報錯。如果strict sql_mode沒有被指定,那麽會向該列中插入‘0000-00-00 00:00:00‘並且產生一個warning。
同樣的,我們來測試下:
mysql> show variables like ‘explicit_defaults_for_timestamp‘;
+---------------------------------+-------+
| Variable_name | Value |
+---------------------------------+-------+
| explicit_defaults_for_timestamp | ON |
+---------------------------------+-------+
mysql> create table t2
-> (
-> ts1 timestamp,
-> ts2 timestamp,
-> ts3 timestamp default ‘2010-01-01 00:00:00‘
-> );
Query OK, 0 rows affected (0.02 sec)
mysql> show create table t2\G
*************************** 1. row ***************************
Table: t2
Create Table: CREATE TABLE `t2` (
`ts1` timestamp NULL DEFAULT NULL,
`ts2` timestamp NULL DEFAULT NULL,
`ts3` timestamp NULL DEFAULT ‘2010-01-01 00:00:00‘
) ENGINE=InnoDB DEFAULT CHARSET=utf8
1 row in set (0.01 sec)
mysql> insert into t2 values (null,null,null);
Query OK, 1 row affected (0.01 sec)
mysql> select * from t2;
+------+------+------+
| ts1 | ts2 | ts3 |
+------+------+------+
| NULL | NULL | NULL |
+------+------+------+
1 row in set (0.00 sec)
-- 指定NOT NULL
mysql> create table t3
-> (
-> ts1 timestamp,
-> ts2 timestamp,
-> ts3 timestamp not null
-> );
Query OK, 0 rows affected (0.01 sec)
mysql> show create table t3\G
*************************** 1. row ***************************
Table: t3
Create Table: CREATE TABLE `t3` (
`ts1` timestamp NULL DEFAULT NULL,
`ts2` timestamp NULL DEFAULT NULL,
`ts3` timestamp NOT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8
1 row in set (0.01 sec)
mysql> insert into t3 values (null,null,null);
ERROR 1048 (23000): Column ‘ts3‘ cannot be null
mysql> insert into t3 (ts1,ts2) values (null,null);
Query OK, 1 row affected, 1 warning (0.01 sec)
mysql> show warnings;
+---------+------+------------------------------------------+
| Level | Code | Message |
+---------+------+------------------------------------------+
| Warning | 1364 | Field ‘ts3‘ doesn‘t have a default value |
+---------+------+------------------------------------------+
mysql> select * from t3;
+------+------+---------------------+
| ts1 | ts2 | ts3 |
+------+------+---------------------+
| NULL | NULL | 0000-00-00 00:00:00 |
+------+------+---------------------+
從表結構上看出,在參數開啟的情況下MySQL默認會為timestamp列添加 null default null屬性,而且MySQL也沒有為第一個timestamp字段設置該列為current timestamp值。timestamp 字段寫入null值,寫入之後存儲的就是null值,而不是當前的時間。當timestamp 字段指定NOT NULL時,若顯式插入NULL則報錯提示:該字段不能為空;若不顯式插入該字段且SQL_MODE不包含‘NO_ZERO_DATE‘,則會向該列中插入‘0000-00-00 00:00:00‘並且產生一個warning。
總結:
實際情況下,我們經常會這樣創建表:
CREATE TABLE `table_name` (
`increment_id` INT UNSIGNED NOT NULL auto_increment COMMENT ‘自增主鍵‘,
...
`create_time` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT ‘創建時間‘,
`update_time` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT ‘修改時間‘,
PRIMARY KEY (`increment_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
此時timestamp字段會指定NOT NULL,這時建議explicit_defaults_for_timestamp
參數采用默認的OFF,這樣當timestamp字段顯式插入NULL值時不報錯,特別是程序sql寫的不規範時,可以避免程序插入報錯。
在不同環境間,此參數建議統一 ,不然可能出現程序在這個環境運行正常 在另外一個環境卻出現報錯的情況。筆者了解到亞馬遜RDS MySQL5.7實例該參數默認為ON,在環境遷移時要特別註意下該參數。
參考: <http://suo.im/5bDU2o> <http://suo.im/4AJeM9>
【MySQL】explicit_defaults_for_timestamp 參數詳解