HandyCafe Docs
it-admin owner

数据库维护

数据库维护页面是本地 HandyCafe 数据库的备份与养护中心。在此页面,您可以查看数据库的健康状况、运行一次性维护任务、安排自动维护和备份,以及从先前的快照恢复服务器。

数据库健康状况

数据库健康状况部分显示数据库的当前状态。您可以随时使用刷新按钮重新加载这些数值。

健康面板报告以下内容:

  • 数据库大小: 主数据库文件的总大小。
  • 预写日志: 预写日志(WAL)文件的大小。
  • 页数: 数据库文件包含的页数。
  • 空闲页: 空闲列表上可通过 vacuum 回收的未使用页数。
  • 上次备份: 最近一次备份的时间戳。若从未备份,则显示从未运行
  • 上次维护: 最近一次 vacuum 的时间戳。
  • 上次完整性检查: 最近一次完整性检查的时间戳,并带有状态指示器,显示数据库是否健康或是否发现问题。
  • 日志条目: 审计日志中当前存储的行数。

在这些数据下方,该部分还会列出日志模式自动 vacuum 设置、页大小以及磁盘上的备份数量。

展开条目可查看数据库中每个表的逐表行数。

手动操作

手动操作部分会立即运行一次性维护任务。同一时间只能运行一个操作。每个操作完成后会显示一条确认提示,部分操作还会在本部分上方显示结果摘要。

  • 立即备份: 创建当前数据库的原子快照。新快照会出现在备份历史列表中。
  • Vacuum: 回收未使用的页并对数据库文件进行碎片整理。结果摘要会报告之前的大小、之后的大小、回收的空间以及耗时。
  • 完整性检查: 运行完整的损坏检查。它较慢但全面。结果会在完整性报告对话框中打开。
  • 快速检查: 运行快速的结构健全性检查。结果同样会在完整性报告对话框中打开。
  • 分析: 更新查询规划器统计信息。
  • 优化: 运行 SQLite 的增量优化器。
  • 截断 WAL: 刷新并截断预写日志文件。结果摘要会报告 WAL 帧数、检查点帧数以及耗时。
  • 清理旧日志: 删除早于配置保留窗口的日志条目。结果摘要会报告删除的行数、剩余的行数以及耗时。

完整性报告

完整性检查或快速检查之后,完整性报告对话框会打开。当数据库健康时,它会确认数据库完整性已通过验证。当 SQLite 报告问题时,对话框会列出问题并建议从已知良好的备份恢复。对话框还会显示该检查的耗时。

自动维护

自动维护部分用于安排 vacuum、完整性检查和日志清理的自动运行。

  • 启用计划维护: 打开或关闭计划维护周期。
  • 频率: 选择每天每周每月
  • 每天的小时: 选择周期运行的本地时间小时。

自动备份

自动备份设置会定期拍摄快照,以确保单次损坏永远不会抹掉一整天的数据。

  • 启用计划备份: 打开或关闭计划备份。
  • 频率: 选择每天每周每月
  • 每天的小时: 选择备份运行的本地时间小时。
  • 保留最近: 要保留的快照数量,介于 1 到 365 之间。超出此数量的较旧快照将被移除。
  • 备份文件夹: 存储快照的目录。留空则使用应用数据目录内的默认文件夹。

日志保留

日志保留设置控制审计日志条目在维护时被移除之前保留多长时间。使用滑块设置**保留(天)**数值。支持的范围为 7 到 730 天。

使用本部分底部的保存按钮存储自动维护、自动备份和日志保留设置。

备份历史

备份历史部分列出本地存储的快照。对于每个备份,表格会显示:

  • 文件: 快照文件名。
  • 创建时间: 拍摄快照的日期和时间。
  • 大小: 快照文件的大小。
  • 来源: 备份的触发方式。自动备份为计划,应用启动时拍摄的备份为启动,使用立即备份创建的备份为手动

每一行提供两个操作:

  • 恢复: 用所选快照替换正在运行的数据库。在替换之前,会自动保存当前数据库的恢复前安全副本。随后应用会关闭并重启,以使快照生效。在恢复开始之前,系统会要求您确认。
  • 删除: 从磁盘移除快照文件。在文件被删除之前,系统会要求您确认。此操作无法撤销。

如果尚不存在任何快照,该部分会提示您运行立即备份或等待下一个计划周期。

云备份

云备份部分介绍存储在 HandyCafe 服务器上的异地加密快照,可从任意 HandyCafe 安装中恢复。

此功能标记为即将推出,目前尚不可用。开关和配置字段会保存在本地,以便该功能向您的账户开放时设置已就绪。可用字段包括启用云备份、一个同时备份徽标、海报和待机画面等媒体资源的选项、端点以及存储桶 / 存储区

重要提示

  • 恢复操作会关闭并重启服务器应用。在恢复之前,请通知任何活跃的时段。
  • 恢复操作总会先保存当前数据库的恢复前安全副本,因此可以通过恢复该安全副本来撤销一次恢复。
  • 请将备份文件夹放在有足够可用空间的存储上,以容纳保留最近中设置的快照数量。
  • 对大型数据库运行完整性检查或 vacuum 可能需要一些时间。同一时间只能运行一个手动操作。