---
title: "物理备份与恢复概述 - OceanBase 数据库 V4.3.5 | OceanBase 文档中心"
description: 物理备份与恢复概述 备份恢复是 OceanBase 数据库高可用特性的核心组件，主要用于保障数据的安全，包括预防存储介质损坏和用户的错误操作等。如果存储介质损坏或者用户误操作而导致了数据丢失，可以通过恢复的方式恢复用户的数据。 概述 OceanBase 数据库的备份恢复模块提供了备份、恢复、清理三大功能。 Ocean…
---
切换语言

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

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.3.5 LTS

# 物理备份与恢复概述

更新时间：2026-04-07 20:57:20

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

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

## 概述

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

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

数据备份指的是备份数据的功能，该功能分为全量备份和增量备份两种：

- 全量备份是指备份所有的宏块。
 - 增量备份是指备份上一次备份以后新增和修改过的宏块。

#### 注意

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

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

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

  #### 说明

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

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

物理恢复整体架构如下：

1. 物理恢复支持租户级恢复和表级恢复

      - 租户级别恢复：租户级恢复是基于已有数据的备份重建新租户的过程。租户恢复保证了跨表、跨分区的全局一致性。
      - 表级别恢复：表级恢复是从备份数据中将用户指定的表恢复到一个已存在的租户，并且该已存在的租户与原表所在的租户可以是同一个租户，也可以是同一集群中的不同租户，还可以是不同集群中的租户。
 2. 租户级恢复又支持全量恢复和快速恢复

   #### 注意

   通过快速恢复方式恢复出来的租户不支持手动发起合并，不支持数据备份，也不支持 Switchover/Failover 成主库，只能作为备库存在。

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

      - 完全恢复：不指定恢复的时间戳。
      - 指定 SCN 或者时间戳的不完全恢复：其中，SCN 是 OceanBase 数据库内部精确的版本号。时间戳在 Oracle 模式下精确到纳秒，没有精度丢失；时间戳在 MySQL 模式下精确到微秒，会丢失微秒之后的精度。

物理恢复流程请参见[恢复流程](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002014019)。

## 备份介质要求

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

### SDK 版本要求

对象存储 SDK 版本与 observer 版本对应关系如下：

|  | oss-c-sdk | s3-cpp-sdk |
| --- | --- | --- |
| 4.3.4 及以上版本 | 3.11.2 | 1.11.156 |

### 接口要求

- 阿里云 OSS：

     - 支持阿里云官方的 OSS，依赖的接口如下表所示。

      | 接口名 | 描述 |
      | --- | --- |
      | PutObject | 上传单个对象 |
      | DeleteObject | 删除单个对象 |
      | DeleteObjects | 批量删除对象 |
      | GetObject | 获取某个对象 |
      | ListObjects | 列举存储空间中的所有对象（依赖强一致） |
      | HeadObject | 获取某个对象的元数据 |
      | AppendObject | 以追加写的方式上传对象 |
      | PutObjectTagging（可选项） | 设置或更新对象的标签 |
      | GetObjectTagging（可选项） | 获取对象标签 |
      | InitiateMultipartUpload | 初始化分片上传 |
      | UploadPart | 上传分片 |
      | CompleteMultipartUpload | 合并已上传分片为一个对象 |
      | AbortMultipartUpload | 取消分片上传，删除已上传的分片 |
      | ListMultipartUploads | 列出已经初始化但还未完成或还未终止的分片信息 |
      | ListParts | 列出上传任务中已完成上传的分片信息 |
     - 仅支持 V1 签名算法。
 - NFS：要求其版本为 NFS 3 及以上版本。
 - 兼容 S3 协议的对象存储（例如：华为 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 节点到备份介质的读写性能，以作为备份性能的参考。有关 `test_io_device` 和 `io_adapter_benchmark` 命令的详细说明及使用，参见 [test_io_device](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002016161) 和 [io_adapter_benchmark](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002016160)。

## 目录结构

### 数据备份目录

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

```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_2_inc_start.obbak                        // 增量备份起始占位符
│   └── backup_set_2_inc_end_success_20230111T194420.obbak  // 增量备份结束占位符
└── backup_set_1_full                                        // 全量备份集，文件结尾为 full 表示是全量备份，inc 表示是增量备份
    ├── backup_set_1_full_20230111T193330_20230111T193420.obbak //占位符，展示全量备份的开始和结束时间
    ├── single_backup_set_info.obbak                        // 当前备份集的元信息
    ├── tenant_backup_set_infos.obbak                       // 当前租户的全量备份集信息
    ├── infos
    ├── logstream_1                                          // 1 号日志流
    └── logstream_1001                                       // 1001 号日志流

```

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

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

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

     - `backup_set_1_full_20230111T193330_20230111T193420.obbak`：该文件展示了当前备份集的 ID、开始和结束的时间。此文件仅用来展示信息。
     - `single_backup_set_info.obbak`：该文件记录了当前备份集的元信息，包括备份的位点、依赖的日志等信息。
     - `tenant_backup_set_infos.obbak`：该文件记录了当前租户已有的所有备份集的元信息。
     - `infos`：该目录记录了数据备份集的元信息。
     - `logstream_1`：该目录记录了 1 号日志流的所有数据，1 号日志流是 OceanBase 数据库租户的系统日志流。
     - `logstream_1001`：该目录记录了 1001 号日志流的所有数据，大于 1000 的日志流是 OceanBase 数据库租户的用户日志流。

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

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

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

```

### 日志归档目录

对于 NFS、OSS、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
        ├── 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 的 id，也是一个单调递增的整数。

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

     - `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 数据库租户的系统日志流。
     - `logstream_1001`：该目录记录了 1001 号日志流的日志文件，大于 1000 的日志流是 OceanBase 数据库租户的用户日志流。

## 与 V3.x/V2.x 版本相关功能的差异性对比

### 日志归档

| 差异项 | V3.x/V2.2x | V4.x |
| --- | --- | --- |
| 归档级别 | 集群级 | 租户级 |
| 归档粒度 | 按分区 | 按日志流 |
| 权限要求 | 只能通过 `sys` 租户操作，例如设置归档路径、开启归档、查看归档进度等 | 既可以通过 `sys` 租户操作，也可以通过用户租户的管理员用户操作 |
| 使用方式 | 1. 通过 `ALTER SYSTEM SET BACKUP_DEST` 语句设置集群级备份路径 2. 通过 `ALTER SYSTEM SET BACKUP_DEST_OPTION` 语句设置 Piece 切换周期，默认不开启切 Piece 的功能 | 通过 `ALTER SYSTEM SET LOG_ARCHIVE_DEST` 语句设置租户级归档路径以及 Piece 切换周期，默认为 `1d` 即 1 天，且日志归档路径与数据备份路径可以分别独立配置 |
| 切 Piece 功能 | 允许不开启切 Piece 的功能且默认不开启 | 仅允许开启切 Piece 功能，且默认周期 1 天 |
| 归档延迟时间的设置方法 | 通过 `ALTER SYSTEM SET LOG_ARCHIVE_CHECKPOINT_INTERVAL` 语句设置 | 通过 `ALTER SYSTEM SET ARCHIVE_LAG_TARGET` 语句设置 |
| `sys` 租户下 执行 `ALTER SYSTEM ARCHIVELOG` 语句后的结果 | 开启当前集群中所有租户的归档，在归档开启后新建的租户也会自动开启归档 | 开启当前集群中所有租户的归档，在归档开启后新建的租户不会自动开启归档 |
| 归档日志压缩功能 | 通过 `ALTER SYSTEM SET BACKUP_LOG_ARCHIVE_OPTION` 设置 | 不支持 |
| 归档视图 | 归档相关视图主要为以下 3 个：   - CDB_OB_BACKUP_ARCHIVELOG - CDB_OB_BACKUP_ARCHIVELOG_SUMMARY - CDB_OB_BACKUP_PIECE_FILES | 归档相关视图为以下 8 个：   - CDB_OB_ARCHIVELOG - DBA_OB_ARCHIVELOG - CDB_OB_ARCHIVELOG_SUMMARY - DBA_OB_ARCHIVELOG_SUMMARY - CDB_OB_ARCHIVE_DEST - DBA_OB_ARCHIVE_DEST - CDB_OB_ARCHIVELOG_PIECE_FILES - DBA_OB_ARCHIVELOG_PIECE_FILES |
| 归档介质要求 | 要求必须是 SSD | 可以是 HDD 或者 SSD |
| 归档文件数量 | 文件数量和分区数成正比，百万分区场景下，会产生海量小文件的问题。 | 文件数量少，与分区数无关，不会存在海量小文件的问题 |
| 备库归档 | 不支持 | 支持 |

### 数据备份

| 差异项 | V3.x/V2.2x | V4.x |
| --- | --- | --- |
| 备份级别 | 集群级 | 租户级 |
| 权限 | 只能通过 `sys` 租户操作，例如设置备份路径，开始备份，查看备份进度等 | 既可以通过 `sys` 租户操作，也可以通过用户租户的管理员用户操作 |
| 备份路径的设置方法 | 通过 `ALTER SYSTEM SET BACKUP_DEST` 语句设置集群级的备份路径 | 通过 `ALTER SYSTEM SET DATA_BACKUP_DEST` 语句设置租户级备份路径，且数据备份路径与日志归档路径可以分别独立配置 |
| 指定路径的数据备份 | `sys` 租户通过执行 `ALTER SYSTEM BACKUP TENANT tenant_name_list TO backup_destination;` 语句发起 | 不支持 |
| BACKUP PLUS ARCHIVELOG 功能 | 不支持 | 支持 |
| 空间膨胀 | 备份期间保留快照点，会导致备份期间存储空间膨胀 | 不保留快照点，不会导致空间膨胀 |
| 备库备份 | 不支持 | 支持 |
| 视图 | 备份相关视图主要为以下 5 个：   - CDB_OB_BACKUP_JOB_DETAILS - CDB_OB_BACKUP_SET_DETAILS - CDB_OB_BACKUP_SET_EXPIRED - CDB_OB_BACKUP_PROGRESS - CDB_OB_BACKUP_SET_FILES | 备份相关视图主要为以下 10 个：   - CDB_OB_BACKUP_JOBS - DBA_OB_BACKUP_JOBS - CDB_OB_BACKUP_JOB_HISTORY - DBA_OB_BACKUP_JOB_HISTORY - CDB_OB_BACKUP_TASKS - DBA_OB_BACKUP_TASKS - CDB_OB_BACKUP_TASK_HISTORY - DBA_OB_BACKUP_TASK_HISTORY - CDB_OB_BACKUP_SET_FILES - DBA_OB_BACKUP_SET_FILES |

### 物理恢复

| 差异项 | V3.x/V2.2x | V4.x |
| --- | --- | --- |
| 数据路径 | 在恢复命令中提供集群级备份路径 | 需要同时提供数据备份和日志归档 2 个路径 |
| 恢复并发度设置 | 在发起恢复命令前，通过 `ALTER SYSTEM SET RESTORE_CONCURRENCY` 语句设置 | 在恢复命令中指定 `concurrecy` |
| 秘钥管理方式 | 1. Internal 模式不需要设置秘钥信息 2. kms 模式在原服务可访问的情况下，也不需要提供秘钥信息 | 1. 需要单独备份主密钥信息 2. 恢复时需要指定主密钥地址 |
| 恢复完成后的租户角色 | 主租户，即主库 | 备租户，即备库 |
| 升级 | 恢复过程中会自动升级租户 | 恢复完成后需要手动升级租户 |
| 表级恢复 | 支持，且仅支持将表恢复到新租户（恢复过程中创建的租户）中，不支持恢复到已存在的租户中 | V4.2.1 版本开始支持，仅支持将表恢复到已存在的租户中，不支持恢复到新租户（恢复过程中创建的租户）中 |
| 快速恢复 | 不支持 | V4.3.3 版本开始支持 |
| 通过 `ADD RESTORE SOURCE` 语句来恢复 | 支持 | 不支持 |

## 生态伙伴认证情况

已与 OceanBase 数据库完成认证的备份恢复生态伙伴，参见 [产业生态伙伴](https://www.oceanbase.com/partner/product-ecology)。

在 [产业生态伙伴](https://www.oceanbase.com/partner/product-ecology) 页面的 **方案类型选择** 中，选择 **数据集成与备份** > **备份恢复**，即可查看目前与 OceanBase 数据库完成认证的备份恢复生态伙伴列表，以及认证的版本情况和证书的有效期限。

## 相关文档

关于物理备份与恢复的更多详细介绍，请参见 [备份恢复](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002014020) 章节。

 上一篇 下一篇 ![有帮助](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) 咨询热线