---
title: "dump_backup | OceanBase 文档中心"
description: dump_backup dump_backup 功能是 ob_admin 的一个子功能，可解析用于物理备份的数据备份内容。本文主要介绍 dump_backup 的几种用法。 help 命令 您可使用该命令输出 dump_backup 的使用方法。 ./ob_admin dump_backup --help 输出为： …
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

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

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

# dump_backup

更新时间：2023-08-03 17:20:32

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V3.1.4/zh-CN/1800.supporting-tools/100.ob-admin/600.dump_backup.md)  

dump_backup 功能是 ob_admin 的一个子功能，可解析用于物理备份的数据备份内容。本文主要介绍 dump_backup 的几种用法。

## help 命令

您可使用该命令输出 dump_backup 的使用方法。

```SQL
./ob_admin dump_backup --help

```

输出为：

```SQL
Usage: dump_backup command [command args] [options]
commands:
 -h,--help                     display this message.
options:
 -d,--data-file-path           absolute data file path with file prefix
 -o,--offset                   data file offset
 -l,--data-length              data length
 -f,--file-path                relative data file path
 -s,--storage-info             oss/cos should provide storage info
 -q,--quiet                    log level: ERROR
 -k,--master_key               master key, hex str
 -m,--master_key_id            master key id
 -e,--encrypt_config_file      encrypt config file
 -c,--check_exist              check file is exist or not
samples:
  dump meta:
 ob_admin dump_backup -dfile:///home/admin/backup_info
  dump macro:
 ob_admin dump_backup -dfile:///home/admin/macro_block_1.0 -o1024 -l2048
  dump data with -f:
 ob_admin dump_backup -f/home/admin/macro_block_1.0 -o1024 -l2048
  dump data with -s:
 ob_admin dump_backup -d'oss://home/admin/backup_info' -s'host=http://oss-cn-hangzhou-zmf.aliyuncs.com&access_id=111&access_key=222'
 ob_admin dump_backup -d'cos://home/admin/backup_info' -s'host=http://cos.ap-nanjing.myqcloud.com&access_id=111&access_key=222&appid=333'

```

参数说明：

- `-d` 代表绝对路径，即需要指定备份数据的绝对路径。
 - `-f` 代表相对路径，指定相对路径。
 - `-o` 和 `-l` 是可选择参数，对于覆盖写的 `backup info` 等文件不需要指定这两个参数，对于追加写的 `macro_block` 则需要指定对应的参数。

## cluster backup info

集群级别的元信息都使用覆盖写的方式，这里包含了 cluster_backup_xxx 的文件和 `tenant_name_info` 以及 `tenant_info`，dump 的例子如下：

```SQL
./ob_admin dump_backup -f cluster_backup_piece_info

```

输出为：

![cluster backup info 输出](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/0897238361/p360970.png)

## partition 元信息

partition 的元信息使用追加写的方式，所以您需要先使用以下命令找到 `-o` 和 `-l` 参数的值。

```SQL
./ob_admin dump_backup -f 1001/data/backup_set_1_full_20211115/backup_1/meta_index_file

```

输出为：

![命令输出截图](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/0897238361/p354901.png)

您可根据输出查找对应的 partition 元信息，比如需要查找表为 `1100611139453783`，分区为 `82` 的 partition 元信息，对应的 `-o` 为 `138668`，`-d` 为 `1628`，则可运行以下命令解析 partition 元信息：

```SQL
./ob_admin dump_backup -f 1001/data/backup_set_1_full_20211115/backup_1/meta_file_0 -o 138668 -l 1628

```

## 宏块数据

宏块数据和 partition 元信息类似，也使用追加写的方式。因此您需要先使用以下命令解析宏块的 `index` 文件，找到对应的 `-o` 和 `-l` 参数。

```SQL
./ob_admin dump_backup -f 1001/data/backup_set_1_full_20211115/data/1100611139453778/0/major_data/macro_block_index_1

```

输出为：

![命令输出截图](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/0897238361/p355219.png)

您可根据输出查找对应的宏块，比如查找 `-o` 为 `0`，`-l` 为 `4096` 的宏块，可运行以下命令解析宏块数据：

```SQL
./ob_admin dump_backup -f 1001/data/backup_set_1_full_20211118/data/1100611139453785/0/major_data/macro_block_1.0 -o0 -l4096

```

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