關於MySQL event的一些整理

靜以致遠√團團發表於2015-07-31

MySQL5.1.xx版本中引入了一項新特性EVENT,實現類似Oracle的JOB功能

要檢視當前是否已開啟事件排程器,可執行如下SQL:

SHOW VARIABLES LIKE 'event_scheduler';

+-----------------+-------+
| event_scheduler | OFF   |
+-----------------+-------+

開啟排程器

SET GLOBAL event_scheduler = 1;

或者

SET GLOBAL event_scheduler = ON;

注意MySQL配置檔案中新增配置實現重啟後仍然有效

my.ini or my.cnf 中的
[mysqld]
新增 event_scheduler=ON


建立事件(CREATE EVENT)

基本語法

CREATE EVENT [IF NOT EXISTS] event_name
ON SCHEDULE schedule
[ON COMPLETION [NOT] PRESERVE]
[ENABLE | DISABLE]
[COMMENT 'comment']
DO sql_statement;

schedule:
AT TIMESTAMP [+ INTERVAL INTERVAL]
| EVERY INTERVAL [STARTS TIMESTAMP] [ENDS TIMESTAMP]

INTERVAL:
quantity {YEAR | QUARTER | MONTH | DAY | HOUR | MINUTE |
            WEEK | SECOND | YEAR_MONTH | DAY_HOUR | DAY_MINUTE |
            DAY_SECOND | HOUR_MINUTE | HOUR_SECOND | MINUTE_SECOND}


[IF NOT EXISTS]
使用IF NOT EXISTS,只有在同名event不存在時才建立,否則忽略。建議不使用以保證event建立成功。


event_name

 

名稱最大長度可以是64個位元組。名字必須是當前Dateabase中唯一的,同一個資料庫不能有同名的event。
使用event常見的工作是建立表、插入資料、刪除資料、清空表、刪除表。

ON SCHEDULE

ON SCHEDULE 計劃任務,有兩種設定計劃任務的方式:
1. AT 時間戳,用來完成單次的計劃任務。
2. EVERY 時間(單位)的數量時間單位[STARTS 時間戳] [ENDS時間戳],用來完成重複的計劃任務。

在兩種計劃任務中,時間戳可以是任意的TIMESTAMP 和DATETIME 資料型別,時間戳需要大於當前時間。
在重複的計劃任務中,時間(單位)的數量可以是任意非空(Not Null)的整數式,時間單位是關鍵詞:YEAR,MONTH,DAY,HOUR,MINUTE 或者SECOND。

提示: 其他的時間單位也是合法的如:QUARTER, WEEK, YEAR_MONTH,DAY_HOUR,DAY_MINUTE,DAY_SECOND,HOUR_MINUTE,HOUR_SECOND, MINUTE_SECOND,不建議使用這些不標準的時間單位。

[ON COMPLETION [NOT] PRESERVE]
ON COMPLETION參數列示"當這個事件不會再發生的時候",即當單次計劃任務執行完畢後或當重複性的計劃任務執行到了ENDS階段。而PRESERVE的作用是使事件在執行完畢後不會被Drop掉,建議使用該引數,以便於檢視EVENT具體資訊。

[ENABLE | DISABLE]
引數Enable和Disable表示設定事件的狀態。Enable表示系統將執行這個事件。Disable表示系統不執行該事件。

可以用如下命令關閉或開啟事件:
ALTER EVENT event_name  ENABLE/DISABLE

[COMMENT 'comment']
註釋會出現在後設資料中,它儲存在information_schema表的COMMENT列,最大長度為64個位元組。'comment'表示將註釋內容放在單引號之間,建議使用註釋以表達更全面的資訊。

DO sql_statement 
DO sql_statement欄位表示該event需要執行的SQL語句或儲存過程。這裡的SQL語句可以是複合語句。

使用BEGIN和END識別符號將複合SQL語句按照執行順序放在之間。當然SQL語句是有限制的,對它的限制跟函式Function和觸發器Trigger 中對SQL語句的限制是一樣的,如果你在函式Function 和觸發器Trigger 中不能使用某些SQL,同樣的在EVENT中也不能使用。明確的來說有下面幾個:
LOCK TABLES
UNLOCK TABLES
CREATE EVENT
ALTER EVENT
LOAD DATA


1)首先來看一個簡單的例子來演示每秒插入一條記錄到資料表

USE test;
CREATE TABLE aaa (timeline TIMESTAMP);
CREATE EVENT e_test_insert
ON SCHEDULE EVERY 1 SECOND 
DO INSERT INTO test.aaa VALUES (CURRENT_TIMESTAMP);
等待3秒鐘後,再執行查詢成功。


2) 5天后清空test表:

CREATE EVENT e_test
ON SCHEDULE AT CURRENT_TIMESTAMP + INTERVAL 5 DAY
DO TRUNCATE TABLE test.aaa;


3) 2007年7月20日12點整清空test表:

CREATE EVENT e_test
ON SCHEDULE AT TIMESTAMP '2007-07-20 12:00:00'
DO TRUNCATE TABLE test.aaa;


4) 每天定時清空test表:

CREATE EVENT e_test
ON SCHEDULE EVERY 1 DAY
DO TRUNCATE TABLE test.aaa;


5) 5天后開啟每天定時清空test表:

CREATE EVENT e_test
ON SCHEDULE EVERY 1 DAY
STARTS CURRENT_TIMESTAMP + INTERVAL 5 DAY
DO TRUNCATE TABLE test.aaa;


6) 每天定時清空test表,5天后停止執行:

CREATE EVENT e_test
ON SCHEDULE EVERY 1 DAY
ENDS CURRENT_TIMESTAMP + INTERVAL 5 DAY
DO TRUNCATE TABLE test.aaa;


7) 5天后開啟每天定時清空test表,一個月後停止執行:

CREATE EVENT e_test
ON SCHEDULE EVERY 1 DAY
STARTS CURRENT_TIMESTAMP + INTERVAL 5 DAY
ENDS CURRENT_TIMESTAMP + INTERVAL 1 MONTH
DO TRUNCATE TABLE test.aaa;
[ON COMPLETION [NOT] PRESERVE]可以設定這個事件是執行一次還是持久執行,預設為NOT PRESERVE。


8) 每天定時清空test表(只執行一次,任務完成後就終止該事件):

DELIMITER $$

CREATE EVENT e_test

ON SCHEDULE EVERY 1 DAY
ON COMPLETION NOT PRESERVE
DO TRUNCATE TABLE test.aaa;

END
$$
DELIMITER ;

9)每天的 10點執行一次update_test的儲存過程


DELIMITER $$
CREATE EVENT event_update_test
ON SCHEDULE EVERY 1 DAY
STARTS '2015-07-31 10:00:00'
ON  COMPLETION  PRESERVE
ENABLE
DO
BEGIN
call update_test();
END
$$
DELIMITER ;




修改事件(ALTER EVENT)
ALTER EVENT event_name
[ON SCHEDULE schedule]
[RENAME TO new_event_name]
[ON COMPLETION [NOT] PRESERVE]
[COMMENT 'comment']
[ENABLE | DISABLE]
[DO sql_statement]


1) 臨時關閉事件

ALTER EVENT e_test DISABLE;


2) 開啟事件

ALTER EVENT e_test ENABLE;


3) 將每天清空test表改為5天清空一次:

ALTER EVENT e_test
ON SCHEDULE EVERY 5 DAY;


刪除事件(DROP EVENT)


語法很簡單,如下所示:

DROP EVENT [IF EXISTS] event_name


例如刪除前面建立的e_test事件

DROP EVENT e_test;


當然前提是這個事件存在,否則會產生ERROR 1513 (HY000): Unknown event錯誤,因此最好加上IF EXISTS

DROP EVENT IF EXISTS e_test;


來自 “ ITPUB部落格 ” ,連結:http://blog.itpub.net/29320885/viewspace-1757617/,如需轉載,請註明出處,否則將追究法律責任。

相關文章