MySQLのイベントスケジューラーを使ってデータ定期削除・集計を自動化する手順｜CREATE EVENTの実践

この記事のポイント

・MySQLイベントスケジューラーはcronを使わずDBの中で定期処理を自動化できる
・event_scheduler=ONをmy.cnfに設定して永続化することが前提
・CREATE EVENTでSQL文を定期実行し、SHOW EVENTSで状態を確認できる
・実行ログはperformance_schemaのevents_statements_historyで追うことができる

mysql> SHOW VARIABLES LIKE 'event_scheduler';
+-----------------+-------+
| Variable_name   | Value |
+-----------------+-------+
| event_scheduler | OFF   |
+-----------------+-------+

mysql> SET GLOBAL event_scheduler = ON;
Query OK, 0 rows affected (0.00 sec)

mysql> SHOW VARIABLES LIKE 'event_scheduler';
+-----------------+-------+
| Variable_name   | Value |
+-----------------+-------+
| event_scheduler | ON    |
+-----------------+-------+

[mysqld]
# イベントスケジューラーを常時有効化する
event_scheduler = ON

sudo systemctl restart mysqld
sudo systemctl status mysqld

CREATE EVENT イベント名
  ON SCHEDULE スケジュール定義
  [ON COMPLETION [NOT] PRESERVE]
  [ENABLE | DISABLE]
  DO
  実行するSQL文またはBEGIN...END;

-- app_logsテーブルから90日以上前のレコードを毎日02:00に削除する
CREATE EVENT evt_purge_old_logs
  ON SCHEDULE EVERY 1 DAY
  STARTS CURDATE() + INTERVAL 2 HOUR
  ON COMPLETION PRESERVE
  ENABLE
  DO
    DELETE FROM app_logs
    WHERE created_at < NOW() - INTERVAL 90 DAY;

-- 毎月1日03:00にmonthly_summaryテーブルを更新する
CREATE EVENT evt_monthly_summary
  ON SCHEDULE EVERY 1 MONTH
  STARTS '2026-10-01 03:00:00'
  ON COMPLETION PRESERVE
  ENABLE
  DO BEGIN
    -- 前月分の集計をmonthly_summaryへ挿入する
    INSERT INTO monthly_summary (year_month, total_orders, total_amount)
    SELECT
      DATE_FORMAT(ordered_at, '%Y-%m'),
      COUNT(*),
      SUM(amount)
    FROM orders
    WHERE ordered_at >= LAST_DAY(NOW() - INTERVAL 1 MONTH) - INTERVAL DAY(LAST_DAY(NOW() - INTERVAL 1 MONTH))-1 DAY
      AND ordered_at <  LAST_DAY(NOW() - INTERVAL 1 MONTH) + INTERVAL 1 DAY
    ON DUPLICATE KEY UPDATE
      total_orders = VALUES(total_orders),
      total_amount = VALUES(total_amount);
  END;

-- 2026-10-01 00:00:00に1回だけ実行して定義も削除するイベント
CREATE EVENT evt_oneshot_migration
  ON SCHEDULE AT '2026-10-01 00:00:00'
  DO
    UPDATE users SET status = 'active' WHERE status = 'pending' AND created_at < '2026-01-01';

-- 現在のデータベースのイベントを確認する
SHOW EVENTS;

-- または全データベースのイベントを確認する
SELECT
  EVENT_SCHEMA,
  EVENT_NAME,
  STATUS,
  EXECUTE_AT,
  INTERVAL_VALUE,
  INTERVAL_FIELD,
  LAST_EXECUTED,
  NEXT_NOT_CACHED_AT
FROM information_schema.EVENTS\G

EVENT_SCHEMA: appdb
EVENT_NAME: evt_purge_old_logs
STATUS: ENABLED
EXECUTE_AT: NULL
INTERVAL_VALUE: 1
INTERVAL_FIELD: DAY
LAST_EXECUTED: 2026-09-21 02:00:01
NEXT_NOT_CACHED_AT: 2026-09-22 02:00:01

-- イベントを無効化（一時停止）する
ALTER EVENT evt_purge_old_logs DISABLE;

-- イベントを再び有効化する
ALTER EVENT evt_purge_old_logs ENABLE;

-- イベントを削除する
DROP EVENT IF EXISTS evt_purge_old_logs;

-- イベントによるSQL実行履歴を確認する
SELECT
  EVENT_NAME,
  SQL_TEXT,
  TIMER_START,
  TIMER_END,
  ERRORS,
  ROWS_AFFECTED
FROM performance_schema.events_statements_history_long
WHERE CURRENT_SCHEMA = 'appdb'
ORDER BY TIMER_START DESC
LIMIT 10;

# MySQLエラーログでイベント関連エラーを確認する
sudo grep -i 'event\|scheduler' /var/log/mysqld.log | tail -20

-- イベント作成者の権限を確認する
SHOW GRANTS FOR 'イベント作成ユーザー'@'localhost';

-- MySQLとOSのタイムゾーンを確認する
mysql> SELECT @@global.time_zone, @@session.time_zone, NOW();
+--------------------+---------------------+---------------------+
| @@global.time_zone | @@session.time_zone | NOW()               |
+--------------------+---------------------+---------------------+
| SYSTEM             | SYSTEM              | 2026-09-21 14:30:00 |
+--------------------+---------------------+---------------------+

# OS側のタイムゾーンを確認する
timedatectl | grep 'Time zone'

[mysqld]
# MySQLのタイムゾーンを日本時間に固定する
default-time-zone = '+09:00'