1. 程式人生 > >【MySQL】explicit_defaults_for_timestamp 參數詳解

【MySQL】explicit_defaults_for_timestamp 參數詳解

類型 ngs 不能 插入 nod 表結構 從表 *** 建議

簡介:
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 參數詳解