2021-02-23

最近在研究GBase 8a这个数据库，看到一个好文，转发大家一起进步

一、简单概念

      Event直观翻译就是事件，GBase 8a数据库具有EVENT事件的能力。所谓的EVENT事件其实就是在相应的时刻调用的过程式数据库对象。一个事件可调用一次，也可周期性的自动调用，事件是由一个特定的线程来管理的，GBase 8a数据库称之为事件调度器。
      其实吧，事件和触发器类似，都是在某些事情发生的时候启动。当数据库上启动一条语句的时候，触发器就启动了，而事件是根据调度事件来启动的。由于他们彼此相似，所以事件也称为临时性触发器。

二、GBase 8a的EVENT与操作系统层上的CRONTAB区别

      1）CRONTAB：事件调度精度只能到分钟

                  操作系统层面上的CRONTAB是CRON TABLE的简写，可以叫它作业列表或者定时任务。CRONTAB定时任务的执行事件粒度支持分、时、日、月、周，也就是说事件粒度精度到分钟。

      2）GBase 8a数据库EVENT：调度精度可到秒级

                  EVENT的调度时间颗粒支持比较丰富，可支持YEAR 、QUARTER 、MONTH 、DAY 、HOUR 、MINUTE、WEEK 、SECOND 、YEAR_MONTH 、DAY_HOUR 、DAY_MINUTE 、DAY_SECOND 、HOUR_MINUTE、HOUR_SECOND、MINUTE_SECON。

三、使用EVENT

       每个事件EVENT由一条CREATE EVENT语句实现，语句中包括两部分内容：

       一是事件调度（EVENT SCHEDULE），表示事件何时启动以及按什么频率启动；

       二是事件动作（EVENT ACTION），这是事件启动时执行的代码，事件的动作包含一条SQL 语句，它可能是一个简单地 INSERT或者UPDATE语句，也可以使一个存储过程或者BEGIN...END语句块，这两种情况允许执行多条 SQL。

       一个事件可以是活动（打开）的或停止（关闭）的，活动意味着事件调度器检查事件动作是否必须调用，停止意味着事件的声明存储在目录中，但调度器不会检查它是否应该调用。在一个事件创建之后，它立即变为活动的，一个活动的事件可以执行一次或者多次。

     1）创建事件EVENT语法

        CREATE [DEFINER = { user | CURRENT_USER }] EVENT
        [IF NOT EXISTS] event_name
        ON SCHEDULE schedule
        [ON COMPLETION [NOT] PRESERVE]
        [ENABLE | DISABLE]
        [COMMENT 'comment']
        AT timestamp [+ INTERVAL interval] ... | EVERY interval
        [STARTS timestamp [+ INTERVAL interval] ...] [ENDS timestamp [+ INTERVAL interval] ...]
        DO event_body;

      参数说明：

        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 event_now
        on schedule
        at now()
        do insert into events_list values('event_now', now());

    2）打开、关闭、查看调度器

       事件调度器 event_scheduler 负责调用事件，它默认是关闭的。这个调度器不断地监视一个事件是否要调用，查看调度器的状态。

        gbase> show variables like '%event_scheduler%'; -- 查看调度器状态
        +-----------------+--------+
        | Variable_name | Value |
        +-----------------+--------+
        | event_scheduler | OFF |
        +-----------------+--------+

        开启调度器的方式：

        方式1：通过设置参数打开

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

                ***此方式退出SESSION，再重新登录就可以生效，而无需重启GBase 8a 服务。

        方式2：通过配置文件 gbase_8a_gbase.cnf 开启事件调度器，下面内容添加到[gbased]标签下

                event_scheduler = 1 #或者 ON 

                ***此方式需重启GBase 8a 服务才能生效。

        关闭调度器的方式：

        方式与打开一致，但是参数值变为OFF或者0.

        确认调度器是否处在监控状态的方式：

        

四、修改事件

        alter event 语句可以修改事件的定义和属性。语法格式如下：

        ALTER
        EVENT event_name
        [ON SCHEDULE schedule]
        [ON COMPLETION [NOT] PRESERVE]
        [RENAME TO new_event_name]
        [ENABLE | DISABLE]
        [COMMENT 'comment']
        [DO event_body]

        修改EVENT示例：

        修改上面例子中每分钟启动事件为每 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 [IF EXISTS] event_name;

六、使用范例       

        创建测试表
        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 |
        +-------------+---------------------

七、注意事项

    1）默认创建事件存储在当前库中，也可显示指定事件创建在哪个库中；
    2）通过 show events 只能查看当前库中创建的事件；
    3）事件执行完即释放，如立即执行事件，执行完后，事件便自动删除，多次调用事件或等待执行事件可以查看到。
    4）如果两个事件需要在同一时刻调用， gbase 会确定调用他们的顺序，如果要指定顺序，需要确保一个事件至少在另一个事件 1 秒后执行。
    5）对于递归调度的事件，结束日期不能在开始日期之前。

    原文出处《GBase 8a EVENT那点事儿》https://www.modb.pro/db/45533