数据库事件（event）

GBase 8a数据库的EVENT（事件）功能是一种在数据库内部创建和管理定时任务的机制。它允许您根据预设的时间计划，自动执行单条SQL语句或存储过程，从而实现数据清理、统计、归档等周期性维护工作的自动化。

一、核心概念

事件（EVENT）与触发器（TRIGGER）不同。触发器由特定的数据操作（如INSERT、UPDATE、DELETE）触发，而事件由时间计划触发。事件可以被看作是一个“时间触发器”。

其运行依赖于一个名为event_scheduler的后台线程。在使用前，必须确保此调度器已开启。

二、配置与启用

1.  检查事件调度器状态

   SHOW VARIABLES LIKE 'event_scheduler';
   
   如果返回值为OFF，则表示未开启。

2.  开启事件调度器
   ◦   动态开启（立即生效，数据库重启后可能失效）：

       SET GLOBAL event_scheduler = ON;
       -- 或
       SET GLOBAL event_scheduler = 1;
       
   ◦   通过配置文件开启（永久生效，需重启数据库服务）：

       在数据库配置文件（如gbase_8a_gbase.cnf）的[gbased]段中添加或修改：

       event_scheduler = ON
       
       然后重启GBase 8a数据库服务。

三、事件管理语法

1.  创建事件
   基本语法如下：
   CREATE EVENT [IF NOT EXISTS] 事件名称
   ON SCHEDULE 执行计划
   [ON COMPLETION [NOT] PRESERVE]
   [ENABLE | DISABLE]
   [COMMENT '注释']
   DO
       要执行的SQL语句或语句块;
   
   ◦   执行计划： 核心部分，定义何时执行。

       ▪   单次执行： AT 'YYYY-MM-DD HH:MM:SS' 或 AT NOW() + INTERVAL 1 HOUR。

       ▪   循环执行： EVERY 间隔时间 [STARTS 开始时间] [ENDS 结束时间]。例如：EVERY 1 DAY STARTS '2024-12-25 02:00:00'。

   ◦   ON COMPLETION： 定义事件到期后的行为。

       ▪   NOT PRESERVE（默认）：事件执行完成后自动删除。

       ▪   PRESERVE：事件执行完成后保留定义。

   ◦   ENABLE/DISABLE： 指定事件创建后的状态，默认为ENABLE（启用）。

2.  修改事件
   ALTER EVENT 事件名称
   [ON SCHEDULE ...]
   [RENAME TO 新事件名称]
   [ENABLE | DISABLE]
   [DO ...];
   

3.  删除事件
   DROP EVENT [IF EXISTS] 事件名称;
   

4.  查看事件
   -- 查看当前数据库所有事件
   SHOW EVENTS;
   -- 查看事件创建语句
   SHOW CREATE EVENT 事件名称;
   

四、使用示例

示例1：创建一次性事件
创建一个立即执行的事件，向日志表插入记录。
-- 创建日志表
CREATE TABLE IF NOT EXISTS sys_event_log (
   id INT PRIMARY KEY AUTO_INCREMENT,
   event_name VARCHAR(100),
   execute_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
   remark VARCHAR(500)
);

-- 创建事件：立即执行一次
CREATE EVENT event_demo_once
ON SCHEDULE AT NOW()
ON COMPLETION NOT PRESERVE -- 执行后删除
DO INSERT INTO sys_event_log(event_name, remark) VALUES ('event_demo_once', '此事件在创建时立即执行一次');

示例2：创建每天定时执行的事件
创建一个事件，每天凌晨2点清理30天前的日志。
CREATE EVENT event_daily_clean_log
ON SCHEDULE EVERY 1 DAY
STARTS TIMESTAMP(CURRENT_DATE) + INTERVAL 1 DAY + INTERVAL 2 HOUR -- 明天凌晨2点开始
ON COMPLETION PRESERVE
COMMENT '每日清理过期日志'
DO
   DELETE FROM sys_operation_log WHERE create_time < DATE_SUB(NOW(), INTERVAL 30 DAY);

示例3：创建复杂的周期性事件
创建一个事件，每周一上午8点生成上周的销售周报统计，并插入汇总表。
CREATE EVENT event_weekly_sales_report
ON SCHEDULE EVERY 1 WEEK
STARTS '2024-12-30 08:00:00' -- 从下周一上午8点开始
DO
BEGIN
   -- 使用BEGIN...END可以执行多条SQL
   INSERT INTO sales_weekly_summary (stat_week, total_amount, report_time)
   SELECT 
       YEARWEEK(DATE_SUB(CURDATE(), INTERVAL 7 DAY)), -- 上周的年份和周数
       SUM(amount),
       NOW()
   FROM sales_order
   WHERE order_date BETWEEN DATE_SUB(CURDATE(), INTERVAL 13 DAY) AND DATE_SUB(CURDATE(), INTERVAL 7 DAY);
   
   -- 可以继续执行其他语句
   UPDATE system_status SET last_report_gen = NOW() WHERE id = 1;
END;

示例4：修改和禁用事件
-- 将每日清理事件改为每12小时执行一次
ALTER EVENT event_daily_clean_log
ON SCHEDULE EVERY 12 HOUR;

-- 临时禁用某个事件
ALTER EVENT event_weekly_sales_report DISABLE;

示例5：查看和删除事件
-- 查看所有事件列表
SHOW EVENTS;

-- 查看具体事件的定义
SHOW CREATE EVENT event_weekly_sales_report;

-- 删除事件
DROP EVENT IF EXISTS event_demo_once;

五、重要注意事项

1.  时间设置：AT子句中的时间必须是未来的时间，不能是过去的时间。
2.  执行权限：创建事件的用户需要具有EVENT权限。
3.  资源与监控：高频率（如每秒）的事件会持续消耗系统资源。请通过SHOW PROCESSLIST;监控event_scheduler线程的活动。
4.  错误处理：事件执行中的错误会记录到数据库错误日志中，但事件本身会继续按照计划运行。建议在事件体的SQL中做好容错处理。
5.  与cron对比：数据库事件比操作系统cron任务（分钟级）的调度精度更高（可达秒级），且与数据库上下文集成更好，无需网络连接和外部认证，但会占用数据库自身的资源。

通过合理使用EVENT功能，可以极大地简化数据库的日常维护和管理工作。建议从简单的任务开始，逐步验证其稳定性和对系统的影响。