# BR 的使用 - 单表备份

__*BR 使用*__
__*BR 单表备份*__

```
br backup table \
    --pd "${PDIP}:2379" \
    --db test \
    --table usertable \
    --storage "s3://backup-data/table-db-usertable/2022-01-30/" \
    --ratelimit 128 \
    --log-file backuptable.log
```
-------------------------------------------------------------
要备份集群中指定单张表的数据,可使用 br backup table 命令。同样可通过 br backup table --help 来获取子命令 table 的使用帮助。

用例:将表 test.usertable 备份到 s3 的名为 backup-data 的 bucket 下面的 table-db-usertable/2022-01-30/ 前缀目录下。

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

table 子命令有 --db 和 --table 两个选项,分别用来指定数据库名和表名。其他选项的含义与备份 TiDB 集群快照相同。