br/use-br-command-line-tool: supplement br note (#6000) (#6116)

pingcap · Aug 5, 2021 · affee15 · affee15
1 parent 441738e
commit affee15
Showing 1 changed file with 4 additions and 0 deletions.
diff --git a/br/use-br-command-line-tool.md b/br/use-br-command-line-tool.md
@@ -361,6 +361,10 @@ br restore db \
 
 In the above command, `--db` specifies the name of the database to be restored. For descriptions of other options, see [Restore all backup data](#restore-all-the-backup-data)).
 
+> **Note:**
+>
+> When you restore the backup data, the name of the database specified by `--db` must be the same as the one specified by `-- db` in the backup command. Otherwise, the restore fails. This is because the metafile of the backup data ( `backupmeta` file) records the database name, you can only restore data to the database with the same name. The recommended method is to restore the backup data to the database with the same name in another cluster.
+
 ### Restore a table
 
 To restore a single table to the cluster, execute the `br restore table` command. To get help on this command, execute `br restore table -h` or `br restore table --help`.