aiops/docs/sqlite-maintenance-runbook.md

SQLite 维护与恢复演练 Runbook

适用范围：独立二进制或 local 模式的 SQLite 数据库。生产维护只能在批准的维护窗口执行；高峰期及存在活跃写入时禁止 VACUUM。

维护前检查

1. 确认近期备份可读取，并记录当前数据库、WAL 文件大小。
2. 在发布窗口停止 AIOps 写入进程；VACUUM 期间必须保持停写。
3. 使用绝对路径，禁止将 /、工作区或未核实的路径作为维护目标。

./scripts/sqlite-maintenance.sh \
  --maintenance-window \
  --db /srv/aiops/sqlite3.db \
  --backup-dir /srv/aiops/backups/sqlite \
  --pid-file /srv/aiops/.aiops.pid

脚本会先执行 SQLite .backup，对备份运行 PRAGMA integrity_check，再执行 wal_checkpoint(TRUNCATE)、VACUUM 和最终完整性检查。备份校验失败时不会进入空间回收步骤。

恢复演练

1. 在隔离测试目录复制一份备份，绝不直接覆盖生产库。
2. 用同版本二进制指向副本启动，并验证 /version、管理员登录、服务器列表和近期 Agent 指标查询。
3. 对副本执行 PRAGMA integrity_check，并记录恢复耗时、RPO、RTO 与验证结果。
4. 仅当演练通过后，更新备份巡检记录；生产恢复须由值班负责人批准并保留原库只读副本。

线上当前风险

sqlite3.db 与 WAL 已达到多 GB 级别。请先完成备份恢复演练，再安排维护窗口；本次整改不会在在线服务上直接运行 VACUUM。