Docs
文档目录

备份与恢复

功能概述

数据库备份与恢复(Backups & Restoration)是 Agentbase 面向生产级业务数据库(如项目 企业智能客服与知识中台 enterprise-ai-hub-210 下的 企业智能客服业务库 enterprise_biz_db)提供的数据级容灾与防误删保障能力。在企业日常运维、批量数据割接、智能体自动化工单处理或重大版本升级过程中,单靠表结构级的 Schema 版本回滚 无法恢复被误删或被错误覆写的业务行记录(例如误操作清空了 customer_tickets 客户工单表)。通过 Databases → 选择数据库 → Backups 页签,管理员可以一键创建永久保留的手动备份快照(Manual Backups)、灵活配置按小时/按天/按周/按月自动运行的定时备份策略(Automated Backup Policies),并在需要时将任意已完成(Complete)的备份恢复到全新的独立数据库(非破坏性旁路验证)或直接覆盖当前数据库(原位回滚)。

Agentbase 的备份引擎与底层 OceanBase 存储深度协同,完整捕获目标数据库在备份时间点的全部逻辑表结构(Tables、Columns、Indexes、Comments)与全量行记录(Rows 及行级 $permissions),确保跨表数据一致性与恢复后的即刻可用性。


核心概念与架构

Agentbase 数据库备份体系由“备份触发器(手动触发 vs 定时策略调度)→ 异步快照构建状态机 → 生命周期保留期清理(Retention GC)→ 双模式恢复引擎(新库旁路恢复 vs 原库覆盖恢复)”四大核心模块组成。下图展示了数据库备份从创建、定制定时策略到执行数据恢复的完整架构流转:

备份与恢复:流程示意,不是运行截图

流程示意,不是运行截图;按箭头阅读步骤或状态之间的关系。

查看流程图大图

核心概念与状态说明

核心概念 / 状态技术定义与生命周期规则
套餐与部署门控(Availability Gate)数据库备份属于 Cloud 付费套餐专属能力,由“是否为 Cloud 环境 + 当前组织套餐是否包含备份权益(backupsEnabled)”共同门控:
• 自托管部署(Self-hosted):Backups 页签展示锁定视图与功能说明,不开放备份操作入口。
• Cloud 未开通套餐:显示套餐升级引导,且在新建数据库弹窗中会明确提示“此数据库不会被备份”。
手动备份(Manual Backup)由管理员在重大变更前主动触发的单次快照。备份名称由系统按创建时间戳自动生成(不支持自定义命名),默认永久保留(Never expires),除非管理员手动将其删除或删除所属数据库。
定时备份策略(Backup Policy)定义自动周期性备份的执行频率(Hourly / Daily / Weekly / Monthly)、UTC 执行时间点与快照保留时长(Retention Period)。每个数据库可创建的策略总数受当前套餐的 backupPolicies 配额约束。
备份状态枚举(Backup Status)• Waiting / Pending:备份任务已提交并在队列中等待执行。
• Processing:后台 Worker 正在生成一致性快照(右下角浮窗实时显示进度)。
• Complete:备份已完成并显示占用体积(Size);仅状态为 Complete 的备份才开放「恢复(Restore)」操作。
• Failed:备份执行失败,不可用于恢复。
级联删除边界(Cascade Deletion)• 删除定时策略:会同时级联永久删除该策略名下产生的所有历史备份快照(手动创建的备份不受影响)。
• 删除整个数据库:会同时永久删除该数据库关联的全部手动备份、定时策略与历史备份快照,不可恢复。

角色、入口与关联关系

控制台入口与路由

与其他模块的关联关系

  1. 与表、列、行(Tables & Rows)的关系:备份以整个 Database(如 enterprise_biz_db) 为最小粒度,一次性涵盖库内所有表(如 customer_tickets 及其他关联业务表)的表结构、索引定义、行数据与行级权限($permissions),天然保证同一数据库内多张关联表的跨表快照一致性。

  2. 与 Schema 版本控制(Schema Versions)互补:

    • Schema 版本控制 用于管理表结构定义演进与结构投影秒级切换(不回退行数据)。

    • Backups(备份与恢复) 用于保护全量业务行数据与物理状态。在对生产表执行大规模数据清洗、删除列或删除表之前,强烈建议先在 Backups 页签创建一个手动备份。


功能详解与操作指南

1. 创建手动备份快照(Manual Backup)

在执行高风险数据操作(如批量脚本更新 customer_tickets 工单状态或删除历史表)前,请按以下步骤创建手动备份:

  1. 进入 Databases → enterprise_biz_db → Backups 页签。

  2. 在页面右侧「备份(Backups)」列表区域上方,点击 手动备份(Manual backup) 按钮。

  3. 在弹出的确认对话框中核对说明:

    • 手动备份创建后将永久保留,直到您手动将其删除。

    • 备份耗时取决于当前数据库内的表数量与总行数据规模,期间不会阻塞线上正常读写。

  4. 点击确认提交。系统立即将备份任务加入异步队列,页面右下角会弹出 「备份状态」 实时进度浮窗,列表自动刷新(每页展示 12 条备份记录)。

  5. 查看备份列表详情:

    • 备份(Backup):展示以创建时间命名的快照标识,并提供本地时区与 UTC 双时区时间展示。

    • 大小(Size):当备份状态变为 Complete 后,精确展示该快照的数据体积(未完成时显示短横线 -)。

    • 状态(Status):显示 Pending、Processing、Complete、Failed 或 Waiting。

    • 策略(Policy):标识该快照是由 Manual(手动)触发还是由某条具体的定时备份策略生成。

2. 配置定时备份策略(Automated Backup Policies)

为了实现无人值守的日常容灾保护,可在 Backups 页签左侧的策略区域点击 创建策略(Create policy)(若已达当前套餐 backupPolicies 数量上限,按钮将自动隐藏并提示已创建数量与升级入口)。

在「创建策略」弹窗中,支持一次性勾选或配置多条策略并批量提交:

策略类型频率设置(Frequency)执行时间点(UTC 计算)保留时长(Retention)适用业务场景(以 enterprise_biz_db 为例)
预设 Hourly(每小时)每小时自动执行 1 次每整点运行固定保留 1 天(24 小时)核心交易或高频工单库(如 customer_tickets),提供 RPO $\le 1$ 小时的细粒度近线恢复点。
预设 Daily(每天)每天自动执行 1 次可指定每日执行时间(默认 00:00 UTC)固定保留 7 天标准生产业务库日常基线保护,覆盖最近一周内任意一天的回溯需求。
自定义策略(Custom)可选 每小时 / 每天 / 每周 / 每月• 每天:默认 00:00(可选具体时刻)
• 每周:支持多选星期几(默认周一)
• 每月:界面提供月初(1 日)/ 月中(15 日)/ 月末(28 日)选项(当前自定义月度策略固定按每月 28 日 执行)
可选预设档位:3 天 / 1 周 / 2 周 / 1 个月 / 3 个月 / 1 年 / 永久(Forever);或选择 自定义(Custom)(上限为 30 天、4 周或 12 个月,默认 30 天)满足企业特定合规审计归档要求(例如每周日凌晨备份并保留 3 个月,或每月末备份并保留 1 年)。

定时策略管理与删除注意事项

3. 执行数据恢复(Restore Backup)与验证流程

当需要回溯历史数据或从误操作中恢复时,在右侧备份列表中找到状态为 Complete(已完成) 的目标备份行,点击行尾 ⋯ 菜单选择 恢复(Restore)。

恢复弹窗会展示所选备份的名称、完成时间戳与体积大小,并提供两种恢复模式供选择:

模式一:在新数据库中恢复(Restore into a new database,默认且强烈推荐)

这是生产排障与数据比对最安全的无损旁路恢复模式:

  1. 在恢复弹窗中保持选中 在新数据库中恢复。

  2. 填写新数据库名称(Name,必填):例如输入 企业智能客服业务库_1022恢复核验。

  3. 自定义新数据库 ID(Database ID,可选):点击展开自定义输入框,填入如 enterprise_biz_db_restored(规则同新建数据库,严禁与源数据库 ID enterprise_biz_db 相同;留空则系统自动生成唯一 ID)。

  4. 点击提交后,后台 Worker 异步将所选备份完整克隆至新数据库中,源数据库 enterprise_biz_db 的线上读写不受任何影响。

  5. 恢复后核验(Point-in-Time Validation):恢复完成后点击通知跳转至新数据库 enterprise_biz_db_restored,检查 customer_tickets 表中的工单行数(如核对 TK-20261022-001 至 004 的字段状态与 $permissions),确认无误后可通过脚本将误删的特定行精确迁回生产库,或将应用配置的 Database ID 切流至新库。

模式二:在当前数据库中恢复(Restore in current database,原位覆盖)

当确认需要将当前数据库整体回退到备份时间点状态时使用:

  1. 在恢复弹窗中切换选择 在当前数据库中恢复。

  2. 理解破坏性风险:该模式会使用所选备份快照直接覆盖当前数据库 enterprise_biz_db 中的现有表与行数据,备份时间点之后新增或修改的所有数据都将被抹除。

  3. 强制确认门禁:必须手动勾选弹窗中的覆盖风险确认复选框,提交按钮才会激活。强烈建议在执行原位覆盖前,先对当前数据库执行一次「手动备份」保全现场。

4. 清理与批量删除备份快照


常见问题与排障

Q1:为什么进入数据库的 Backups 页签后,看不到「手动备份」和「创建策略」按钮,而是显示锁定视图或升级提示?

原因分析: 数据库备份与恢复是 Cloud 付费套餐受控能力。

  1. 如果您当前使用的是本地 Docker 或私有化自托管部署(Self-hosted)且未开启云端备份组件授权,页面会固定展示锁定说明视图。

  2. 如果在 Cloud 环境中当前组织所处的免费/基础套餐未包含 backupsEnabled 权益,或当前数据库的策略数已达到套餐 backupPolicies 配额上限,创建入口会被隐藏或替换为套餐升级(Upgrade plan)按钮。

Q2:我想删除一条不再需要的「每日定时备份策略」,删除后这几天已经生成的备份快照还会保留吗?

回答: 不会保留! 在 Agentbase 中,定时备份快照的生命周期强绑定于生成它的备份策略。删除一条定时备份策略会级联永久删除该策略名下关联的所有备份快照(不可撤销)。如果您只是想调整备份频率但仍需保留某次历史快照的数据,请先使用该快照执行一次 「在新数据库中恢复」 将数据固定下来,或者额外创建一次 手动备份(手动备份独立存储,不受定时策略删除影响)。

Q3:刚刚触发了手动备份,为什么无法立即点击「恢复」按钮?

原因分析: 备份生成是后台异步过程,依次经历 Waiting / Pending → Processing → Complete 状态。在快照尚未完成全量表结构与行数据物化校验前(即处于 Pending 或 Processing 状态时),为防止恢复出不完整的半成品数据,系统禁止发起恢复操作。请观察页面右下角的「备份状态」进度浮窗,待备份行的状态变为绿色 Complete(已完成) 且显示具体体积(Size)后,行尾 ⋯ 菜单中的 恢复 选项即会自动开放。


相关文档