【MySQL】explicit_defaults_for_timestamp 參數詳解

簡介:
explicit_defaults_for_timestamp 系統變量決定MySQL服務端對timestamp列中的默認值和NULL值的不一樣處理方法。此變量自MySQL 5.6.6 版本引入,分爲全局級別和會話級別,可動態更新,默認值爲OFF。本文主要介紹該參數打開和關閉狀況下對timestamp的影響 。mysql

1.explicit_defaults_for_timestamp = OFF

當該參數默認設置爲OFF時,其行爲以下:sql

  • 在默認狀況下,若是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。code

2.explicit_defaults_for_timestamp = ON

當該參數設置爲ON時,其行爲以下:ci

  • 若是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。

一樣的,咱們來測試下:rem

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。get

總結:it

實際狀況下,咱們常常會這樣建立表:table

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寫的不規範時,能夠避免程序插入報錯。class

在不一樣環境間,此參數建議統一 ,否則可能出現程序在這個環境運行正常 在另一個環境卻出現報錯的狀況。筆者瞭解到亞馬遜RDS MySQL5.7實例該參數默認爲ON,在環境遷移時要特別注意下該參數。

參考: http://suo.im/5bDU2o>

相關文章
相關標籤/搜索