【周期性執行事件】MySQL事件（Event）&任務調度

1.事件簡介

    事件（event）是MySQL在相應的時刻調用的過程式數據庫對象。一個事件可調用一次，也可周期性的啟動，它由一個特定的線程來管理的，也就是所謂的“事件調度器”。

    事件和觸發器類似，都是在某些事情發生的時候啟動。當數據庫上啟動一條語句的時候，觸發器就啟動了，而事件是根據調度事件來啟動的。由於他們彼此相似，所以事件也稱為臨時性觸發器。

    事件取代了原先只能由操作系統的計划任務來執行的工作，而且MySQL的事件調度器可以精確到每秒鍾執行一個任務，而操作系統的計划任務（如：Linux下的CRON或Windows下的任務計划）只能精確到每分鍾執行一次。

2 事件的優缺點
    2.1 優點

    一些對數據定時性操作不再依賴外部程序，而直接使用數據庫本身提供的功能。

    可以實現每秒鍾執行一個任務，這在一些對實時性要求較高的環境下就非常實用了。

    2.2 缺點
    定時觸發，不可以調用。

3 創建事件

    一條create event語句創建一個事件。每個事件由兩個主要部分組成，第一部分是事件調度（event schedule），表示事件何時啟動以及按什么頻率啟動，第二部分是事件動作（event action ），這是事件啟動時執行的代碼，事件的動作包含一條SQL語句，它可能是一個簡單地insert或者update語句，也可以使一個存儲過程或者 benin...end語句塊，這兩種情況允許我們執行多條SQL。

    一個事件可以是活動（打開）的或停止（關閉）的，活動意味着事件調度器檢查事件動作是否必須調用，停止意味着事件的聲明存儲在目錄中，但調度器不會檢查它是否應該調用。在一個事件創建之后，它立即變為活動的，一個活動的事件可以執行一次或者多次。

    3.1 創建語法如下

    CREATE  
        [DEFINER = { user | CURRENT_USER }]  
        EVENT  
        [IF NOT EXISTS]  
        event_name  
        ON SCHEDULE schedule  
        [ON COMPLETION [NOT] PRESERVE]  
        [ENABLE | DISABLE | DISABLE ON SLAVE]  
        [COMMENT 'comment']  
        DO event_body;  
      
    schedule:  
        AT timestamp [+ INTERVAL interval] ...  
      | EVERY interval  
        [STARTS timestamp [+ INTERVAL interval] ...]  
        [ENDS timestamp [+ INTERVAL interval] ...]  
      
    interval:  
        quantity {YEAR | QUARTER | MONTH | DAY | HOUR | MINUTE |  
                  WEEK | SECOND | YEAR_MONTH | DAY_HOUR | DAY_MINUTE |  
                  DAY_SECOND | HOUR_MINUTE | HOUR_SECOND | MINUTE_SECOND}  

 

    名詞解釋：

    event_name ：創建的event名字（唯一確定的）。
    ON SCHEDULE：計划任務。
    schedule: 決定event的執行時間和頻率（注意時間一定要是將來的時間，過去的時間會出錯），有兩種形式 AT和EVERY。
    [ON COMPLETION [NOT] PRESERVE]： 可選項，默認是ON COMPLETION NOT PRESERVE 即計划任務執行完畢后自動drop該事件；ON COMPLETION  PRESERVE則不會drop掉。
    [COMMENT 'comment'] ：可選項，comment 用來描述event；相當注釋，最大長度64個字節。
    [ENABLE | DISABLE] ：設定event的狀態，默認ENABLE：表示系統嘗試執行這個事件， DISABLE：關閉該事情，可以用alter修改
    DO event_body: 需要執行的sql語句（可以是復合語句）。CREATE EVENT在存儲過程中使用時合法的。

    3.2 開啟關閉事件調度器

        3.2.1 MySQL事件調度器event_scheduler負責調用事件，它默認是關閉的。這個調度器不斷地監視一個事件是否要調用， 要創建事件，必須打開調度器。

    mysql> show variables like '%event_scheduler%';  
    +-----------------+-------+  
    | Variable_name   | Value |  
    +-----------------+-------+  
    | event_scheduler | OFF   |  
    +-----------------+-------+  

 

        3.2.2 開啟事件調度器

        通過命令行

        可通過如下任何一個命令行

    SET GLOBAL event_scheduler = ON;  
    SET @@global.event_scheduler = ON;  
    SET GLOBAL event_scheduler = 1;  
    SET @@global.event_scheduler = 1;  

 

        通過配置文件my.cnf

event_scheduler = 1 #或者ON  

 

        查看調度器線程

    mysql> show processlist;  
    +----+-----------------+-----------+------+---------+------+------------------------+------------------+  
    | Id | User            | Host      | db   | Command | Time | State                  | Info             |  
    +----+-----------------+-----------+------+---------+------+------------------------+------------------+  
    |  2 | root            | localhost | NULL | Query   |    0 | NULL                   | show processlist |  
    |  3 | event_scheduler | localhost | NULL | Daemon  |    6 | Waiting on empty queue | NULL             |  
    +----+-----------------+-----------+------+---------+------+------------------------+------------------+  

 

        3.2.3 關閉事件調度器

        通過命令行

        可通過如下任何一個命令行

    SET GLOBAL event_scheduler = OFF;  
    SET @@global.event_scheduler = OFF;  
    SET GLOBAL event_scheduler = 0;  
    SET @@global.event_scheduler = 0;  

 

        通過配置文件my.cnf

        在[mysqld]下增加

event_scheduler = 0 #或者OFF，DISABLED  

 

         查看調度器線程

mysql> show processlist;  
+----+------+-----------+------+---------+------+-------+------------------+  
| Id | User | Host      | db   | Command | Time | State | Info             |  
+----+------+-----------+------+---------+------+-------+------------------+  
|  2 | root | localhost | NULL | Query   |    0 | NULL  | show processlist |  
+----+------+-----------+------+---------+------+-------+------------------+ 

 

 

    3.3 例如：創建一個表記錄每次事件調度的名字和事件戳

    3.3.1 創建測試表

    mysql> drop table if exists events_list;  
    mysql> create table events_list(event_name varchar(20) not null, event_started timestamp not null);  

 

    3.3.2 創建事件1（立即啟動事件）

    create event event_now   
    on schedule   
    at now()   
    do insert into events_list values('event_now', now());  

 

    查看事件執行結果

    mysql> select * from events_list;  
    +------------+---------------------+  
    | event_name | event_started       |  
    +------------+---------------------+  
    | event_now  | 2014-07-01 04:06:40 |  
    +------------+---------------------+  

 

    3.3.3 創建事件2（每分鍾啟動事件）

    create event test.event_minute   
    on schedule   
    every  1 minute    
    do insert into events_list values('event_now', now());  

 

    查看事件執行結果

    mysql> select * from events_list;  
    +------------+---------------------+  
    | event_name | event_started       |  
    +------------+---------------------+  
    | event_now  | 2014-07-01 04:26:53 |  
    | event_now  | 2014-07-01 04:27:53 |  
    | event_now  | 2014-07-01 04:28:53 |  
    +------------+---------------------+  

 

3.3.3 創建事件3（每秒鍾啟動事件）

    CREATE event event_now   
    ON SCHEDULE   
    EVERY 1 SECOND 
    DO INSERT INTO event_test VALUES(1);  

 

3.3.4 創建事件4（每秒鍾調用存儲過程） 

CREATE DEFINER=`root`@`localhost` EVENT `eventUpdateStatus` ON SCHEDULE EVERY 1 SECOND STARTS '2017-11-21 00:12:44' ON COMPLETION PRESERVE ENABLE DO call updateStatus()

 

 

 

    3.4 注意：

    默認創建事件存儲在當前庫中，也可顯示指定事件創建在哪個庫中

    通過show events只能查看當前庫中創建的事件

    事件執行完即釋放，如立即執行事件，執行完后，事件便自動刪除，多次調用事件或等待執行事件可以查看到。

    如果兩個事件需要在同一時刻調用，mysql會確定調用他們的順序，如果要指定順序，需要確保一個事件至少在另一個事件1秒后執行

    對於遞歸調度的事件，結束日期不能在開始日期之前。

    select可以包含在一個事件中，然而他的結果消失了，就好像沒執行過。

4 查看事件

    查看當前所在庫的事件

mysql> show events; 

 

    查看所有事件

 

mysql> select * from mysql.event;  

 

5 修改事件

    一條alter event語句可以修改事件的定義和屬性。我們可以讓一個事件成為停止的或者再次讓它活動，也可以修改一個事件的名字或者整個調度。然而當一個使用 ON COMPLETION NOT PRESERVE 屬性定義的事件最后一次執行后，事件直接就不存在了，不能修改。

    5.1 語法如下：

    ALTER  
        [DEFINER = { user | CURRENT_USER }]  
        EVENT event_name  
        [ON SCHEDULE schedule]  
        [ON COMPLETION [NOT] PRESERVE]  
        [RENAME TO new_event_name]  
        [ENABLE | DISABLE | DISABLE ON SLAVE]  
        [COMMENT 'comment']  
        [DO event_body]  

 

    5.2 例如

    修改上面例子3.3.3 每分鍾啟動事件為每30秒啟動

 

    alter event test.event_minute  
    on schedule   
    every  30 second    
    do insert into events_list values('event_now', now());  

 

 

 

    修改上面例子3.3.3 事件名字為event_second

 

alter event test.event_minute   
rename to test.event_second; 

 

    修改上面例子3.3.3 事件為不活動和再次活動

    alter event test.event_second disable;  
    alter event test.event_second enable;  

 

 

6.刪除事件

    如果一個事件不再需要，我們可以使用一條drop event 語句刪除它。使用這條語句我們不需要等到最后一次事件調用。

    6.1 基本語法

DROP EVENT [IF EXISTS] event_name  

 

    6.2 例如

drop event if exists event_second;  

 

 

 

 

//一個周期性根據時間修改狀態的例子:

1.創建的存儲過程

/*!50003 DROP PROCEDURE IF EXISTS  `updateStatus` */;

DELIMITER $$

/*!50003 CREATE DEFINER=`root`@`localhost` PROCEDURE `updateStatus`()
BEGIN
	UPDATE exam SET `status`="已結束" where  `status` != "已結束" AND  (NOW() - endTime)>0  ;
	UPDATE exam  SET `status`="正在答題"  where   `status` != "已結束" AND ( NOW() - startTime)>=0 
	AND  (NOW() - endTime)<0;
	
	UPDATE haulinfo SET bigStatus="已結束" where  bigStatus != "已結束" AND  (CURDATE() - bigEndDate)>0; 
	UPDATE haulinfo SET bigStatus="進行中" where  bigStatus != "已結束" AND  (CURDATE() - bigEndDate)<0 
	AND  (CURDATE() - bigBeginDate)>=0 ;
	UPDATE project set `status` = "完工" WHERE `status` != "完工" AND (CURDATE() - endDate)>0;
	UPDATE project set `status` = "進行中" WHERE `status` != "完工" AND (CURDATE() - endDate)<0 
	AND  (CURDATE() - startDate)>=0 ;
END */$$
DELIMITER ;

 2.創建任務調度的事件(調用存儲過程)

DELIMITER $$

/*!50106 CREATE DEFINER=`root`@`localhost` EVENT `eventUpdateStatus` ON SCHEDULE EVERY 1 SECOND STARTS '2017-11-21 00:12:44' ON COMPLETION PRESERVE ENABLE DO call updateStatus() */$$
DELIMITER ;

 

 /* ....  */ 在大部分語言中都一樣是注釋。這個之中的語句是不被執行的。

但MYSQL中 為了保持兼容，比如從mysqldump 導出的SQL語句能被其它數據庫直接使用，它把一些特有的僅在MYSQL上的語句放在 /*! ... */ 中，這樣這些語句如果在其它數據庫中是不會被執行，但在MYSQL中它會執行。

 

 

例如:一個定時(每分鍾)調用一個存儲過程，存儲過程根據進入黑名單時間推后一年刪除記錄，也就是從進入表開始計算一年后刪除表

blacklist表結構:

 

 

存儲過程:(根據當前時間與進入黑名單時間差夠一年后刪除)

delimiter //

CREATE PROCEDURE clearEmploutBlack()

BEGIN

delete from blacklist where temporaryInStatus='0' and employeeStatus='1' and TIMESTAMPDIFF(YEAR,time,NOW())=1;

END//

delimiter ;

 

創建事件(每分鍾調用上面存儲過程)

  CREATE event event_clearEmployOutBlack 

    ON SCHEDULE  

    EVERY  1 MINUTE   STARTS NOW()

    DO CALL clearEmploutBlack() ;