# Using `BR`: Restoring a Specified Table

+ (mandatory) **`br restore table`**
+ (mandatory) **`--db:`** The database the table resides
+ (mandatory) **`--table:`** Table to be backed up
+ (optional) **`--storage:`** The backup storage path 
+ (optional) **`--ratelimit:`** The maximum speed per `TiKV` performing restore tasks (in `MiB/s`)
+ (optional) **`--log-file`:** Output log for `BR`

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

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