# BR 的使用 - 全库备份

__*BR 使用*__
__*BR 全库备份*__

```
br backup full \
    --pd "${PDIP}:2379" \
    --backupts '2022-01-30 07:42:23' \
    --storage "s3://backup-data/2022-01-30/" \
    --ratelimit 128 \
    --log-file backupfull.log
```
-------------------------------------------------------------
TiDB 集群快照数据是只包含某个物理时间点上集群的最新的、满足事务一致性的数据。使用 br backup full 可以备份 TiDB 最新的或者指定时间点的快照数据。执行 br backup full --help 可获取该命令的使用帮助。

用例:将时间为 '2022-01-30 07:42:23' 的集群快照数据备份到 S3 的名为 backup-data bucket 下的 2022-01-30/ 前缀目录中。
br backup full \
    --pd "${PDIP}:2379" \
    --backupts '2022-01-30 07:42:23' \
    --storage "s3://backup-data/2022-01-30/" \
    --ratelimit 128 \
    --log-file backupfull.log
以上命令中:
--backupts:快照对应的物理时间点。如果该快照的数据被 GC 了,那么 br backup 命令会报错退出；如果你没有指定该参数,那么 BR 会选取备份开始的时间点所对应的快照。
--ratelimit:每个 TiKV 执行备份任务的速度上限（单位 MiB/s）。
--log-file:BR log 写入的目标文件。
备份期间有进度条在终端中显示,显示效果如下。当进度条前进到 100% 时,说明备份已完成。
br backup full \
    --pd "${PDIP}:2379" \
    --storage "s3://backup-data/2022-01-30/" \
    --ratelimit 128 \
    --log-file backupfull.log
Full Backup <---------/................................................> 17.12%.
在完成备份后,BR 会将备份数据的 checksum 同集群 admin checksum table 的结果比较,以确保备份数据正确性。