AgentbaseDocs
文档目录

备份与恢复

功能概述

数据库备份与恢复(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 原库覆盖恢复)”四大核心模块组成。下图展示了数据库备份从创建、定制定时策略到执行数据恢复的完整架构流转:

flowchart TB
    subgraph Triggers["备份触发方式 (Backup Triggers)"]
        ManualBtn["手动备份 (Manual Backup)<br/>Console 手动点击或命令面板触发<br/>保留策略: 永久保留 (直到手动删除)"]
        PolicySched["定时备份策略 (Backup Policies)<br/>预设 Hourly (留 24h) / Daily (留 7d)<br/>或自定义频率 (每小时/天/周/月) + 自定义保留期"]
    end

    subgraph StateMachine["备份异步执行状态机 (Backup Lifecycle)"]
        Waiting["Waiting / Pending<br/>(已入队等待 Worker 调度)"]
        Processing["Processing<br/>(正在导出库表结构与全量行快照)"]
        Complete["Complete (已完成)<br/>(计算并展示精确备份大小 Size, 解锁恢复入口)"]
        Failed["Failed (失败)<br/>(记录异常原因, 不影响源库在线读写)"]
        Expired["到期自动清理 / 级联删除<br/>(按策略保留期自动 GC 或随策略/数据库一并删除)"]

        Waiting --> Processing
        Processing -->|快照校验成功| Complete
        Processing -->|执行异常| Failed
        Complete -->|到达策略保留期| Expired
    end

    subgraph RestoreModes["双模式数据恢复引擎 (仅 Complete 备份可用)"]
        NewDBRestore["模式 A: 在新数据库中恢复 (默认推荐)<br/>• 将备份复制到全新数据库 (如 enterprise_biz_db_restore_1022)<br/>• 零覆盖风险,支持先做数据核验与跨库比对"]
        InPlaceRestore["模式 B: 在当前数据库中恢复 (原位覆盖)<br/>• 用备份版本直接覆写当前数据库 enterprise_biz_db<br/>• 破坏性操作:需强制勾选确认框,建议先做手动备份"]
    end

    ManualBtn & PolicySched --> Waiting
    Complete --> NewDBRestore & InPlaceRestore

核心概念与状态说明

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

角色、入口与关联关系

控制台入口与路由

与其他模块的关联关系


功能详解与操作指南

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

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

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(可选具体时刻)<br/>• 每周:支持多选星期几(默认周一)<br/>• 每月:界面提供月初(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,默认且强烈推荐)

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

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

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

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


常见问题与排障

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

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

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

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

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

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


相关文档