# Using `BR`: Backing up a Specified Table

+ (mandatory) **`br backup table`**
+ (mandatory) **`--db:`** The database the table resides
+ (mandatory) **`--table:`** Table to be backed up
+ (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`

```
$ ~!@tiup br backup table@!~ \
    ~!@--db universe@!~ \
    ~!@--table planets@!~ \
    --backupts "2022-11-06 19:00:00" \
    --pd "${PDIP}:2379" \
    --storage "/backup" \
    --ratelimit 128 \
    --log-file backuptable.log

tiup is checking updates for component br ...
...
Table Backup <----------------------------------> 100.00%
Checksum <--------------------------------------> 100.00%
[2022/11/06 19:02:23.046 +08:00] [INFO] [collector.go:69]
["Table Backup success summary"]
...
```
```
tidb> ~!@BACKUP TABLE universe.planets@!~ TO 'local:///backup'
   -> RATE_LIMIT = 128 MB/SECOND
   -> SNAPSHOT = '2022-11-06 19:04:00';
+-----------------+---------+--------------------+---------------------+---------------------+
| Destination     | Size    | BackupTS           | Queue Time          | Execution Time      |
+-----------------+---------+--------------------+---------------------+---------------------+
| local:///backup | 6554160 | 437186107803172866 | 2022-11-06 19:04:09 | 2022-11-06 19:04:09 |
+-----------------+---------+--------------------+---------------------+---------------------+
1 row in set (1.58 sec)
```
------------------------------------------------------------------------------------------
To backup a table to in the cluster, run the `br backup table` command. To get help on this command, run the `br backup table --help` command.