【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