# BR 的使用 - 单库恢复

__*BR 使用*__
__*BR 单库恢复*__

```
br restore db \
    --pd "${PDIP}:2379" \
    --db "test" \
    --ratelimit 128 \
    --storage "s3://backup-data/db-test/2022-01-30/" \
    --log-file restore_db.log
```
-------------------------------------------------------------
要将备份数据中的某个数据库恢复到集群中,可以使用 br restore db 命令。执行 br restore db --help 可获取该命令的使用帮助。

用例:将 s3 中名为 backup-data 的 bucket 下的 db-test/2022-01-30/ 中的 test 库的相关数据恢复到集群中。

br restore db \
    --pd "${PDIP}:2379" \
    --db "test" \
    --ratelimit 128 \
    --storage "s3://backup-data/db-test/2022-01-30/" \
    --log-file restore_db.log

br restore db \
    --pd "${PDIP}:2379" \
    --db "test" \
    --ratelimit 128 \
    --storage "s3://backup-data/db-test/2022-01-30/" \
    --log-file restore_db.log

以上命令中 --db 选项指定了需要恢复的数据库名字。其余选项的含义与恢复快照备份数据相同。

注意:

恢复备份数据的时候,--db 选项指定的数据库名必须与执行备份时候 --db选项指定的数据库名相同,否则无法恢复成功。由于备份数据的元文件backupmeta 记录了该数据库名,因此只能将数据恢复到同名的数据库。推荐做法是把备份文件恢复到另一个集群的同名数据库中。