事件(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;


GBase数据库
1 声望2 粉丝

GBase数据库知识分享