# Using `BR`: Backing up a Specified Database

+ (mandatory) **`br backup db`**
+ (mandatory) **`--db:`** Database 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 db@!~ \
    ~!@--db universe@!~ \
    --backupts "2022-11-06 18:30:00" \
    --pd "${PDIP}:2379" \
    --storage "/backup" \
    --ratelimit 128 \
    --log-file backuptable.log

tiup is checking updates for component br ...
...
Database Backup <-------------------------------> 100.00%
Checksum <--------------------------------------> 100.00%
[2022/11/06 18:36:05.748 +08:00] [INFO] [collector.go:69]
["Database Backup success summary"]
...
```
```
tidb> ~!@BACKUP DATABASE universe@!~ TO 'local:///backup'
   -> RATE_LIMIT = 128 MB/SECOND
   -> SNAPSHOT = '2022-11-06 18:52:00';
+-----------------+---------+--------------------+---------------------+---------------------+
| Destination     | Size    | BackupTS           | Queue Time          | Execution Time      |
+-----------------+---------+--------------------+---------------------+---------------------+
| local:///backup | 6567285 | 437185921469382659 | 2022-11-06 18:52:19 | 2022-11-06 18:52:19 |
+-----------------+---------+--------------------+---------------------+---------------------+
1 row in set (1.77 sec)
```
------------------------------------------------------------------------------------------
To restore a database to the cluster, run the `br restore db` command. To get help on this command, run the `br restore db --help` command.