-
Notifications
You must be signed in to change notification settings - Fork 702
Description
Change Request
This repository is ONLY used to solve issues related to DOCS.
For other issues (related to TiDB, PD, etc), please move to other repositories.
Please answer the following questions before submitting your issue. Thanks!
- Describe what you find is inappropriate or missing in the existing docs.
See: https://docs.pingcap.com/tidb/dev/backup-and-restore-tool
- Describe your suggestion or addition.
There are a lot of clarifications which are only historically relevant. By keeping them here, they make it harder for first time readers to process the document:
BR only supports TiDB v3.1 and later versions.
For v3.1 clusters, the new collation framework is not supported, so you can see it as disabled.
For example, assume that data is backed up from a v3.1 cluster and will be restored to a v4.0 cluster.
Meanwhile, because TiDB v4.0 uses leader count for load balancing by default, leaders are greatly different in size, resulting in uneven distribution of backup data on each node.
TiDB v4.0.2 and later versions support backup and restore operations using SQL statements.
If the BR version is earlier than v4.0.3, and the backup duration might exceed the tikv_gc_life_time configuration which is 10m0s by default (10m0s means 10 minutes), increase the value of this configuration item.
Since v4.0.3, BR automatically adapts to GC and you do not need to manually adjust the tikv_gc_life_time value.
For the use-case of backup+upgrade (where some of these restrictions apply), the documentation should be on the manual page for upgrading from the previous series (a new document under Maintain -> Upgrade).
- Provide some reference materials (documents, websites, etc) if you could.
The MySQL docs use the convention of removing the version-specific language in the GA that follows when it was introduced. See this example: