Skip to content

Commit 1c12cb2

Browse files
authored
Br add experimental description for acceleration restore speed (#16266)
1 parent d9b7b88 commit 1c12cb2

File tree

1 file changed

+5
-1
lines changed

1 file changed

+5
-1
lines changed

br/br-snapshot-guide.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -71,7 +71,11 @@ tiup br restore full --pd "${PD_IP}:2379" \
7171
--storage "s3://backup-101/snapshot-202209081330?access-key=${access-key}&secret-access-key=${secret-access-key}"
7272
```
7373

74-
To address the potential bottleneck issue during restoration in large-scale Region scenarios, starting from v7.6.0, BR supports a coarse-grained Region scatter algorithm (experimental). You can enable this algorithm by specifying `--granularity="coarse-grained"`.
74+
> **Warning:**
75+
>
76+
> The coarse-grained Region scatter algorithm (enabled by setting `--granularity="coarse-grained"`) is experimental. It is recommended that you use this feature to accelerate data recovery in clusters with up to 1,000 tables. Note that this feature does not support checkpoint restore.
77+
78+
To further improve the restore speed of large clusters, starting from v7.6.0, BR supports a coarse-grained Region scatter algorithm (experimental) for faster parallel recovery. You can enable this algorithm by specifying `--granularity="coarse-grained"`. After it is enabled, BR can quickly split the restore task into a large number of small tasks and scatter them to all TiKV nodes in batches, thus fully utilizing the resources of each TiKV node for fast recovery in parallel.
7579

7680
During restore, a progress bar is displayed in the terminal as shown below. When the progress bar advances to 100%, the restore task is completed and statistics such as total restore time, average restore speed, and total data size are displayed.
7781

0 commit comments

Comments
 (0)