备份与恢复
数据库备份提供手动备份、定时备份策略与恢复三类能力。进入路径:项目 → Databases → 选择数据库 → Backups 页签。
可用性与前提
- 备份是 Cloud 付费套餐能力,由「是否 Cloud + 当前套餐是否开通备份」门控:
- 自托管部署:备份页显示锁定视图与提示,不出现可用的备份入口。
- Cloud 未开通套餐:显示升级入口;创建数据库时会出现「此数据库不会被备份」警告。
- 策略数量受套餐限制(
backupPolicies):达到上限后「创建策略」按钮隐藏,显示已创建数量与升级提示。
手动备份
- 在备份页右侧「备份」区点击手动备份(或命令面板「创建手动备份」)。
- 确认弹窗提示:手动备份将永久保留,除非手动删除,适用于重大数据变更或回滚保障;过程耗时与数据量相关。
- 提交后备份异步执行,列表自动刷新;右下角「备份状态」浮窗显示进度。
- 备份以创建时间命名,无法自定义名称。
- 列表列:备份(名称 + 双时区时间)/ 大小(仅已完成显示)/ 状态(Pending / Processing / Complete / Failed / Waiting)/ 策略 / 操作。
定时备份策略
「创建策略」弹窗可一次提交多个策略:
| 类型 | 内容 |
|---|---|
| 预设 Hourly | 每小时运行,保留 1 天(24 小时) |
| 预设 Daily | 每天指定时间运行(默认 00:00),保留 7 天 |
| 自定义策略 | 频率(每小时 / 每天 / 每周 / 每月)、时间、保留时长、名称 |
自定义策略字段:
- 频率:每小时 / 每天 / 每周 / 每月;每周需多选星期(默认周一);每日默认 00:00 执行。
- 每月:界面提供月初(1 日)/ 月中(15 日)/ 月末(28 日)选项;自定义月度策略当前固定按 28 日 执行。
- 保留时长:3 天 / 1 周 / 2 周 / 1 个月 / 3 个月 / 1 年 / 永久 / 自定义;自定义上限为 30 天、4 周或 12 个月;默认 30 天。
- 名称:必填,最长 128 字符。
策略卡片显示频率描述、保留时长、最近一次备份时间与按 UTC 计算的下一次运行时间。Console 界面不提供已建策略的编辑或启停开关(API 层支持);策略卡片的「⋯」菜单仅有删除。
删除策略(级联删除备份)
策略删除确认框明确警告:删除策略将同时删除该策略关联的所有备份,此操作不可撤销。
恢复备份
仅状态为 Complete(已完成) 的备份提供「恢复」操作。恢复弹窗展示备份名称、完成时间与大小,二选一:
| 模式 | 行为 | 风险 |
|---|---|---|
| 在新数据库中恢复(默认) | 将所选备份版本的数据库复制到新数据库 | 无覆盖风险。需填写新数据库名称;可展开自定义数据库 ID(不得与源库相同;留空自动生成) |
| 在当前数据库中恢复 | 使用所选备份版本覆盖当前数据库 | 破坏性操作:必须勾选覆盖确认项后才能提交;如需保全现有数据请先手动备份 |
提交后恢复异步执行,完成后可跳转查看恢复出的数据。
删除备份
- 单个删除:备份行「⋯」→「删除」→ 确认;删除不限备份状态。
- 批量删除:多选备份 → 浮动操作栏「删除」→ 确认后并发逐条删除;部分失败会提示哪些未删除。
- 按策略保留期到期后的备份由系统自动删除(策略「永久保留」除外)。
限制与注意事项
- 备份列表每页 12 条。
- 依赖备份做回滚前,建议先确认最近一次备份状态为 Complete。