事件(event)是在相应的时刻调用的过程式数据库对象。一个事件可调用一次,也可周期性的启动,它由一个特定的线程来管理的,也就是所谓的“事件调度器”。
事件和触发器类似,都是在某些事情发生的时候启动。当数据库上启动一条语句的时候,触发器就启动了,而事件是根据调度事件来启动的。由于他们彼此相似,所以事件也称为临时性触发器。
每条create event语句创建一个事件。每个事件由两个主要部分组成,第一部分是事件调度(event schedule),表示事件何时启动以及按什么频率启动;第二部分是事件动作(event action),这是事件启动时执行的代码,事件的动作包含一条SQL语句,它可能是一个简单的INSERT或者UPDATE语句,也可以是一个存储过程或者BEGIN...END语句块,这两种情况允许执行多条SQL。
一个事件可以是活动(打开)的或停止(关闭)的,活动意味着事件调度器检查事件动作是否必须调用,停止意味着事件的声明存储在目录中,但调度器不会检查它是否应该调用。在一个事件创建之后,它立即变为活动的,一个活动的事件可以执行一次或者多次。
一、事件调度器
事件调度器event_scheduler负责调用事件,它默认是打开的。这个调度器不断地监视一个事件是否要调用, 要创建事件,必须打开调度器。
gbase> SHOW VARIABLES LIKE '%event_scheduler%';
| Variable_name | Value |
| event_scheduler | ON |
1 row in set (Elapsed: 00:00:00.00)
开启事件调度器
开启方法
方法一:可通过如下命令行开启事件调度器。
SET GLOBAL event_scheduler = ON;
SET @@global.event_scheduler = ON;
SET GLOBAL event_scheduler = 1;
SET @@global.event_scheduler = 1;
方法二:通过配置文件gbase_8a_gcluster.cnf开启事件调度器。
……
[gbased]
……
event_scheduler= 1 #或者ON
……
查看调度器线程
gbase> show processlist\G
1. row **
Id: 1
User: event_scheduler
Host: localhost
vc: NULL
db: NULL
Command: Daemon
Time: 1034068
State: Waiting for event lock
Info: NULL
2. row **
Id: 621
User: root
Host: localhost
vc: vc1
db: NULL
Command: Sleep
Time: 376038
State:
Info: NULL
2 rows in set (Elapsed: 00:00:00.00)
关闭事件调度器
关闭方法
方法一:可通过如下命令行关闭事件调度器。
SET GLOBAL event_scheduler = OFF;
SET @@global.event_scheduler = OFF;
SET GLOBAL event_scheduler = 0;
SET @@global.event_scheduler = 0;
方法二:通过配置文件gbase_8a_gbase.cnf关闭事件调度器。
……
[gbased]
……
event_scheduler = 0 #或者OFF,DISABLED
……
查看调度器线程
gbase> show processlist\G
1. row **
Id: 621
User: root
Host: localhost
vc: vc1
db: NULL
Command: Sleep
Time: 376262
State:
Info: NULL
2. row **
Id: 883
User: root
Host: 172.168.83.11:44008
vc: NULL
db: NULL
Command: Sleep
Time: 6
State:
Info: NULL
2 rows in set (Elapsed: 00:00:00.00)
二、创建事件
语法格式
CREATE [DEFINER = { user | CURRENT_USER }] EVENT
[IF NOT EXISTS] <event_name>
ON SCHEDULE <schedule>
[ON COMPLETION [NOT] PRESERVE]
[ENABLE | DISABLE]
[GLOBAL | LOCAL]
[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修改。
[GLOBAL | LOCAL]
GLOBAL表示各节点独占执行,LOCAL表示各节点独立执行
DO event_body
需要执行的sql语句(可以是复合语句)。CREATE EVENT在存储过程中使用是合法的。
示例
创建测试表:
gbase> DROP TABLE IF EXISTS events_list;
gbase> CREATE TABLE events_list(event_name VARCHAR(20) NOT NULL, event_started TIMESTAMP NOT NULL);
创建事件1(立即启动事件):
CREATE EVENT event_now
ON SCHEDULE
AT NOW()
DO insert into events_list values('event_now', now());
查看事件执行结果:
gbase> select * from events_list;
+------------+---------------------+
| event_name | event_started |
+------------+---------------------+
| event_now | 2017-07-01 04:06:40 |
+------------+---------------------+
创建事件2(每分钟启动事件):
CREATE EVENT test.event_minute
ON SCHEDULE
EVERY 1 MINUTE
DO insert into events_list values('event_now', now());
查看事件执行结果:
gbase> SELECT * FROM events_list;
+-------------+---------------------+
| event_name | event_started |
+-------------+---------------------+
| event_now | 2017-07-01 04:26:53 |
| event_now | 2017-07-01 04:27:53 |
| event_now | 2017-07-01 04:28:53 |
+-------------+---------------------+
三、查看事件
语法格式
查看当前所在库的事件:
SHOW EVENTS;
查看所有事件:
SELECT * FROM gbase.event;
SELECT * FROM information_schema.events;
四、修改事件
功能说明
一条alter event语句可以修改事件的定义和属性。我们可以让一个事件成为停止的或者再次让它活动,也可以修改一个事件的名字或者整个调度。然而当一个使用 ON COMPLETION NOT PRESERVE 属性定义的事件最后一次执行后,事件直接就不存在了,不能修改。
语法格式
ALTER
EVENT event_name
[ON SCHEDULE schedule]
[ON COMPLETION [NOT] PRESERVE]
[RENAME TO new_event_name]
[ENABLE | DISABLE]
[COMMENT 'comment']
[DO event_body]
示例
修改上面例子中每分钟启动事件为每30秒启动:
ALTER EVENT test.event_minute
ON SCHEDULE
EVERY 30 SECOND
DO INSERT INTO events_list VALUES('event_now', now());
修改上面例子的事件名字为event_second:
ALTER EVENT test.event_minute
RENAME TO test.event_second;
修改上面例子的事件为不活动和再次活动:
ALTER EVENT test.event_second DISABLE;
ALTER EVENT test.event_second ENABLE;
五、删除事件
功能说明
如果一个事件不再需要,我们可以使用一条drop event 语句删除它。使用这条语句我们不需要等到最后一次事件调用。
语法格式
DROP EVENT [IF EXISTS] event_name;
示例
drop event if exists event_second;
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。