#数据库维护

本章介绍 SQLite 与 MySQL 的日常维护事项，帮助保持数据库稳定、可恢复。

#SQLite

#文件与备份

• 数据库是单个文件，路径由 config.toml 的 db.path 指定（模板默认 ./data/astra_schedule.db）
• 备份 = 复制文件。建议先停止服务或使用文件快照，避免复制到写入中的文件（见备份策略）

#文件增长与压缩

SQLite 删除数据后文件大小不会自动缩小。若发现数据库文件异常膨胀（长期频繁写入后），可执行压缩：

# 停止服务后执行
sudo systemctl stop astraschedule
sqlite3 /opt/astraschedule/data/astra.db "VACUUM;"
sudo systemctl start astraschedule

VACUUM 会重写整个数据库文件，执行前务必先备份。一般学校场景数据量小，无需定期压缩。

#完整性检查

sqlite3 /opt/astraschedule/data/astra.db "PRAGMA integrity_check;"

返回 ok 表示数据库完好。

#MySQL

• 依赖数据库自身的自动备份（如 RDS 自动备份，见备份策略）
• 日常维护（慢查询、容量、索引）可在 MySQL 控制台查看
• 不建议在运行中手动改动表结构，表结构变更由后端启动时的 AutoMigrate 完成

#备份有效性验证

备份只有在能恢复时才有价值。建议每学期至少做一次「备份演练」：

1. 导出一份当前 JSON 备份
2. 在测试环境（或临时目录部署一个后端）导入该备份
3. 确认各班级课表、作息、设置、自动任务完整

演练中发现的问题（如备份文件损坏）应尽早处理，避免真正需要恢复时才发现。

#磁盘空间

• 日志文件（journald、Nginx）可能持续增长，建议定期清理或配置日志轮转
• 保留至少 1GB 可用空间，避免数据库写入失败