Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

BR FAQ: add a warning about multi br importing #6263

Merged
merged 6 commits into from
Sep 8, 2021
Merged

BR FAQ: add a warning about multi br importing #6263

Show file tree
Hide file tree
Changes from 3 commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
04207a7
BR FAQ: add a warning about multi br importing
en-jin19 Aug 25, 2021
10d55a3
change a noun
en-jin19 Sep 2, 2021
1f14ac6
fix CI error
en-jin19 Sep 2, 2021
ad8d324
Apply suggestions from code review
en-jin19 Sep 2, 2021
b3cf3c6
Update br/use-br-command-line-tool.md
en-jin19 Sep 2, 2021
62c5fd2
Update br/backup-and-restore-faq.md
TomShawn Sep 8, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions br/backup-and-restore-faq.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -95,3 +95,11 @@ BR does not back up statistics (except in v4.0.9). Therefore, after restoring th
In v4.0.9, BR backs up statistics by default, which consumes too much memory. To ensure that the backup process goes well, the backup for statistics is disabled by default starting from v4.0.10.

If you do not execute `ANALYZE` on the table, TiDB will fail to select the optimized execution plan due to inaccurate statistics. If query performance is not a key concern, you can ignore `ANALYZE`.

## Can I use multiple BR command-lines at the same time to restore the data of a single cluster?
en-jin19 marked this conversation as resolved.
Show resolved Hide resolved

**It is strongly not recommended** to use multiple BR command-lines at the same time to restore the data of a single cluster for the following reasons:
en-jin19 marked this conversation as resolved.
Show resolved Hide resolved

+ When BR restores data, it modifies some of the global configurations of PD. Therefore, if you use multiple BR command-lines for data restoration at the same time, these configurations might be mistakenly overridden and cause abnormal cluster status.
en-jin19 marked this conversation as resolved.
Show resolved Hide resolved
+ BR uses a lot of cluster resources to restore data, so in fact, running BR command-lines in parallel has very limited effects to improve the speed of restoration.
en-jin19 marked this conversation as resolved.
Show resolved Hide resolved
+ There was no test for running multiple BR command-lines in parallel for data restoration, so it is not guaranteed to succeed.
en-jin19 marked this conversation as resolved.
Show resolved Hide resolved
2 changes: 2 additions & 0 deletions br/use-br-command-line-tool.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -307,6 +307,8 @@ To restore the cluster data, use the `br restore` command. You can add the `full
> - Where each peer is scattered to during restore is random. We don't know in advance which node will read which file.
>
> These can be avoided using shared storage, for example mounting an NFS on the local path, or using S3. With network storage, every node can automatically read every SST file, so these caveats no longer apply.
>
> Also, note that you can only run one restore operation for a single cluster at the same time. Otherwise, unexpected circumstances might occur. For details, see [FAQ](/br/backup-and-restore-faq.md#can-i-use-multiple-br-command-lines-at-the-same-time-to-restore-the-data-of-a-single-cluster).
en-jin19 marked this conversation as resolved.
Show resolved Hide resolved

### Restore all the backup data

Expand Down