# Using `BR`: Backing up Entire `TiDB` Cluster Data

+ (mandatory) **`br backup full`**
+ (optional) **`--backupts:`** The physical time of the snapshot, default is **`NOW()`**
+ (optional) **`--storage:`** The backup storage path 
+ (optional) **`--ratelimit:`** The maximum speed per `TiKV` performing backup tasks (in `MiB/s`)
+ (optional) **`--log-file`:** Output log for `BR`

+ For example:
```
$ ~!@tiup br backup full@!~ \
    --pd "10.0.0.148:2379" \
    --backupts "2022-11-06 18:06:23" \
    --storage "/backup" \
    --ratelimit 128 \
    --log-file backupfull.log

tiup is checking updates for component br ...
...
Full Backup <-----------------------------------> 100.00%
Checksum <--------------------------------------> 100.00%
[2022/11/06 18:14:15.969 +08:00] [INFO] [collector.go:69]
["Full Backup success summary"]
...
```
```
tidb> ~!@BACKUP DATABASE *@!~ TO 'local:///backup' 
   -> RATE_LIMIT = 128 MB/SECOND
   -> SNAPSHOT = '2022-11-06 18:42:23';
+-----------------+---------+--------------------+---------------------+---------------------+
| Destination     | Size    | BackupTS           | Queue Time          | Execution Time      |
+-----------------+---------+--------------------+---------------------+---------------------+
| local:///backup | 6655361 | 437185767823900673 | 2022-11-06 18:42:33 | 2022-11-06 18:42:33 |
+-----------------+---------+--------------------+---------------------+---------------------+
1 row in set (3.08 sec)
```
-------------------------------------------------------------
A snapshot of a `TiDB` cluster contains only the latest and transactionally consistent data at a specific time. You can back up the latest or specified snapshot data of a `TiDB` cluster by running the `br backup full` command. To get help on this command, run the `br backup full --help` command.

Example: Back up the snapshot generated at `2022-11-06 18:06:23`.