---
title: "物理备份与恢复概述 - OceanBase AI 数据库 V4.6.3 | OceanBase 文档中心"
description: 物理备份与恢复概述 备份恢复是 OceanBase AI 数据库高可用特性的核心组件，主要用于保障数据的安全，包括预防存储介质损坏和用户的错误操作等。如果存储介质损坏或者用户误操作而导致了数据丢失，可以通过恢复的方式恢复用户的数据。 注意 物理备份功能从 V4.6.2 BP1 版本开始支持。 概述 OceanBase…
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*M1BcQZvbrRMAAAAAQGAAAAgAeiGDAQ/original) OceanBase AI 数据库V 4.6.3

# 物理备份与恢复概述

更新时间：2026-11-19 10:57:58

[编辑](https://github.com/oceanbase/oceanbase-database-ai/edit/V4.6.3/zh-CN/600.manage/600.backup-and-recovery/100.overview-of-physical-backup-and-recovery.md)  

备份恢复是 OceanBase AI 数据库高可用特性的核心组件，主要用于保障数据的安全，包括预防存储介质损坏和用户的错误操作等。如果存储介质损坏或者用户误操作而导致了数据丢失，可以通过恢复的方式恢复用户的数据。

#### 注意

物理备份功能从 V4.6.2 BP1 版本开始支持。

## 概述

OceanBase AI 数据库的备份恢复模块提供了备份、恢复、清理等功能。

### 备份

OceanBase AI 数据库支持租户级别的物理备份。物理备份由数据备份、日志归档两种数据组成，故物理备份由数据备份和日志归档两个功能组合而成。这里的租户指的是用户的 User 租户，不支持 `sys` 租户和 Meta 租户的物理备份。

数据备份指的是备份数据的功能，支持全量备份，即备份所有的宏块。

#### 注意

在进行物理备份操作时，需要先开启日志归档模式后，才能执行数据备份。

数据备份主要备份的数据如下：

- 租户相关信息，包括租户名、集群名、时区（timezone）、副本分布（locality）、租户的兼容模式（MySQL）等
 - 全部用户表数据

  #### 说明

  数据备份会备份系统变量和租户配置项，但不会备份集群级配置项以及私有系统表数据。

日志归档是指日志数据的自动归档功能，OBServer 节点会定期将日志数据归档到指定的备份路径。这个动作是全自动的，不需要外部定期触发。日志归档服务开启后，数据字典也会被归档。

### 恢复

物理恢复整体架构如下：

1. 物理恢复支持租户级恢复：基于已有数据的备份重建新租户的过程。租户恢复保证了跨表、跨分区的全局一致性。
 2. 租户级恢复支持全量恢复

   全量恢复：指恢复宏块数据和增量日志，当所有数据都从备份介质恢复到本地后，完成恢复的租户才可以提供服务。全量恢复的整个过程包括租户系统表和用户表的 Restore 和 Recover 过程。Restore 是将恢复需要的基线数据恢复到目标租户的 OBServer 节点，Recover 是将基线对应的日志恢复到对应的 OBServer 节点。
 3. 为您的物理恢复选择恢复时间点

      - 完全恢复：不指定恢复的时间戳。
      - 指定 SCN 或者时间戳的不完全恢复：其中，SCN 是 OceanBase AI 数据库内部精确的版本号。时间戳精确到微秒，会丢失微秒之后的精度。

### 清理

OceanBase AI 数据库提供了备份数据的自动和手动清理能力，以便用户根据业务场景灵活处理。

- 自动清理：基于恢复窗口（recovery_window）的自动清理机制。用户设置备份数据的过期时间后，系统会定时触发清理任务，清理过期的备份集和数据归档 Piece。
 - 手动清理：手动清理可以分为两类：第一类是手动清理指定的备份集或日志归档 Piece；第二类是手动清空整个路径（数据备份路径或日志归档路径）下所有的备份集或数据归档 Piece。

## 备份介质要求

OceanBase AI 数据库当前版本支持 Azure Blob、AWS S3 以及兼容 S3 协议的对象存储（例如：阿里云 oss、华为 OBS、Google GCS、腾讯云 COS） 等备份介质，部分备份介质需要满足一些基本要求才能使用。

### SDK 版本要求

OceanBase AI 数据库默认使用 obdal 来访问对象存储。obdal 为基于 OpenDAL 开发的对象存储统一框架。有关 OpenDAL 的详细介绍，参见 [OpenDAL](https://github.com/oceanbase/opendal)。

此外，如果需要使用对象存储的 SDK，对象存储的 SDK 版本为 1.11.156。

### 接口要求

- 兼容 S3 协议的对象存储（例如：阿里云 oss、华为 OBS、Google GCS、腾讯云 COS）：

     1. 需要兼容支持下表所示的 S3 API 行为。

       | 接口名 | 描述 |
       | --- | --- |
       | PutObject | 上传单个对象 |
       | DeleteObject | 删除单个对象 |
       | DeleteObjects | 批量删除对象 |
       | GetObject | 下载单个对象 |
       | ListObjects | 列举路径下的所有对象 |
       | HeadObject | 获取某个对象的元数据 |
       | PutObjectTagging（可选项） | 设置对象标签 |
       | GetObjectTagging（可选项） | 获取对象标签 |
       | CreateMultipartUpload | 初始化分片上传 |
       | UploadPart | 上传单个分片 |
       | CompleteMultipartUpload | 合并已上传分片为一个对象 |
       | AbortMultipartUpload | 中止分片上传，删除已上传分片 |
       | ListMultipartUploads | 列出上传的分片 |
       | ListParts | 列出上传任务中已完成上传的分片信息 |
     2. 需要支持 Virtual-hosted–style 的对象访问 URL。有关 Virtual-hosted–style 请求的详细说明，参见 [AWS S3 官网](https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html#virtual-hosted-style-access)。

选择备份介质时，可以通过 ob_admin 工具中的 `test_io_device` 命令来验证该备份介质所提供的 I/O 接口及当前 I/O 权限是否满足备份恢复的需要。同时，还可以使用 ob_admin 工具中的 `io_adapter_benchmark` 命令来查看 OBServer 节点到备份介质的读写性能，以作为备份性能的参考。

## 目录结构

### 数据备份目录

数据备份功能在备份目的地创建的目录以及各目录下保存的文件类型如下所示。

```javascript
data_backup_dest
├── format.obbak                                            // 备份路径的格式化信息
├── check_file
│   └── 1002_connect_file_20230111T193020.obbak             // 连通性检查文件
├── backup_sets                                             // 数据备份列表的汇总目录，记录了所有的数据备份集列表
│   ├── backup_set_1_full_end_success_20230111T193420.obbak // 全量备份结束占位符
│   ├── backup_set_1_full_start.obbak                       // 全量备份起始占位符
└── backup_set_1_full                                        // 全量备份集，目录名结尾为 full 表示是全量备份
    ├── file_list.0.obbak
    ├── backup_set_1_full_20230111T193330_20230111T193420.obbak //占位符，展示全量备份的开始和结束时间
    ├── single_backup_set_info.obbak                        // 当前备份集的元信息
    ├── tenant_backup_set_infos.obbak                       // 当前租户的全量备份集信息
    ├── infoss                                                // 备份集的元信息目录
    ├── logstream_1                                          // 1 号日志流
    ├── logstream_1001                                       // 1001 号日志流
    ├── ls                                                   // 日志流目录
    └── tablet                                               // tablet 目录

```

数据备份目录中，顶层目录包含以下三种数据：

- `format.obbak`：用于记录备份路径的元信息。
 - `check_file`：用于用户数据备份目录的连通性检查。
 - `backup_sets`：数据备份列表的汇总目录，记录了所有的数据备份集列表。
 - `backup_set_1_full`：该目录表示的是一个数据备份集，`backup_set_1` 表示该备份集的 `backup_set_id` 为 `1`；目录名结尾为 `full` 表示全量备份。每一次数据备份都会生成一个对应的备份集，数据备份结束后，该备份集就不会再修改了。

  在一个数据备份集下，主要包含以下数据：

     - `file_list.0.obbak`：该文件用于记录当前目录所包含的文件及目录。
     - `backup_set_1_full_20230111T193330_20230111T193420.obbak`：该文件展示了当前备份集的 ID、开始和结束的时间。此文件仅用来展示信息。
     - `single_backup_set_info.obbak`：该文件记录了当前备份集的元信息，包括备份的位点、依赖的日志等信息。
     - `tenant_backup_set_infos.obbak`：该文件记录了当前租户已有的所有备份集的元信息。
     - `infos`：该目录记录了数据备份集的元信息。
     - `logstream_1`：该目录记录了 1 号日志流的所有数据，1 号日志流是 OceanBase AI 数据库租户的系统日志流。
     - `logstream_1001`：该目录记录了 1001 号日志流的所有数据，大于 1000 的日志流是 OceanBase AI 数据库租户的用户日志流。
     - `ls`：日志流目录，该目录下的内容与对象存储上共享数据的目录结构保持一致。
     - `tablet`：tablet 目录，该目录下的内容与对象存储上共享数据的目录结构保持一致。

### 集群级配置项备份目录

每发起一次集群级配置项的备份，系统就会在指定目录下产生一个集群级配置项的备份文件。具体目录结构如下所示。

```javascript
cluster_parameters_backup_dest
├── cluster_parameter.20240710T103610.obbak # 非默认设置的集群级配置项信息，文件命名格式：`cluster_parameter.[timestamp]`
└── cluster_parameter.20241018T140609.obbak

```

### 日志归档目录

对于 Azure Blob 等备份介质，日志归档功能在归档目的地创建的目录以及各目录下保存的文件类型如下所示。

```javascript
log_archive_dest
    ├── check_file
    │   └── 1002_connect_file_20230111T193049.obbak // 连通性检查文件
    ├── format.obbak                                // 备份路径的格式化信息
    ├── rounds                                      // Rounds 占位符目录
    │   └── round_d1002r1_start.obarc               // Round 开始占位符
    ├── pieces                                      // Piece 占位符目录
    │   ├── piece_d1002r1p1_start_20230111T193049.obarc // Piece 开始占位符，piece_DESTID_ROUNDID_PIECEID_start_DATE
    │   └── piece_d1002r1p1_end_20230111T193249.obarc   // Piece 结束占位符，piece_DESTID_ROUNDID_PIECEID_end_DATE
    └── piece_d1002r1p1                             // Piece 目录，目录命名格式为 piece_DESTID_ROUNDID_PIECEID
        ├── file_list.0.obarc
        ├── piece_d1002r1p1_20230111T193049_20230111T193249.obarc // 记录了 Piece 的连续区间
        ├── checkpoint
        ├── single_piece_info.obarc                 // 记录该 Piece 的元信息
        ├── tenant_archive_piece_infos.obarc        // 记录该 Piece 之前的所有 frozen Piece 的元信息
        ├── file_info.obarc                         // 所有日志流文件列表
        ├── logstream_1                             // 1 号日志流
        └── logstream_1001                          // 1001 号日志流

```

上述日志归档目录中，顶层目录包含以下三种数据：

- `format.obbak`：用于记录归档路径的元信息，包括使用路径的租户等信息。
 - `check_file`：用于用户日志归档目录的连通性检查。
 - `rounds`：日志归档的 Round 汇总列表，记录了所有 Round 的列表。
 - `pieces`：日志归档的 Piece 汇总列表，记录了所有的 Piece 的列表。
 - `piece_d1002r1p1`：日志归档的 Piece 目录，目录命名格式为 `piece_DESTID_ROUNDID_PIECEID`。其中，`DESTID` 指的是 `log_archive_dest` 对应的 id；`ROUNDID` 指的是日志归档 Round 的 id，是一个单调递增的整数；`PIECEID` 指的是日志归档 Piece 的 `piece_id`，也是一个单调递增的整数。

  一个日志归档的 Piece 目录下，又包含以下数据：

     - `file_list.0.obarc`：该文件用于记录当前目录所包含的文件及目录。
     - `piece_d1002r1p1_20230111T193049_20230111T193249.obarc`：该文件展示了当前 Piece 的 id、开始和结束的时间，并且仅用来展示信息。
     - `checkpoint`：该目录是 Active 的 Piece 记录归档位点的目录，ObArchiveScheduler 模块会定期更新该目录的位点信息。
     - `single_piece_info.obarc`：该文件记录了当前 Piece 的元信息。
     - `tenant_archive_piece_infos.obarc`：该文件记录了当前租户内所有 Frozen Pieces 的元信息。
     - `file_info.obarc`：该文件记录了 Piece 内的日志流列表。
     - `logstream_1`：该目录记录了 1 号日志流的日志文件，1 号日志流是 OceanBase AI 数据库租户的系统日志流。
     - `logstream_1001`：该目录记录了 1001 号日志流的日志文件，大于 1000 的日志流是 OceanBase AI 数据库租户的用户日志流。

  上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线
