对集群进行快照备份
全库备份
br backup full --pd "${PD_IP}:${PD_PORT}" --storage "local:///tmp/backup" [--ratelimit 120] [--log-file backupfull.log]
单库备份
br backup db --pd "${PD_IP}:${PD_PORT}" --db test --storage "local:///tmp/backup" [--ratelimit 120] [--log-file backupdb.log]
单表备份
br backup table --pd "${PD_IP}:${PD_PORT}" --db test --table utable --storage "local:///tmp/backup" [--ratelimit 120] [--log-file backuptable.log]
测试
./br backup db --db dba_test --pd "10.0.8.87:2379" --storage "/backup" --ratelimit 128
WXWorkLocalPro_17291570878146.png
-
--backupts：快照对应的物理时间点，格式可以是 TSO 或者时间戳，例如400036290571534337或者2018-05-11 01:42:23 +08:00。如果该快照的数据被垃圾回收 (GC) 了，那么tiup br backup命令会报错并退出。使用日期方式备份时，建议同时指定时区，否则 br 默认使用本地时间构造时间戳，可能导致备份时间点错误。如果你没有指定该参数，那么 br 会选取备份开始的时间点所对应的快照。 -
--storage：数据备份到的存储地址。快照备份支持以 Amazon S3、Google Cloud Storage、Azure Blob Storage 为备份存储，以上命令以 Amazon S3 为示例。详细存储地址格式请参考外部存储服务的 URI 格式。 -
--ratelimit：每个 TiKV 备份数据的速度上限，单位为 MiB/s。
在快照备份过程中，终端会显示备份进度条。在备份完成后，会输出备份耗时、速度、备份数据大小等信息。
Full Backup <-------------------------------------------------------------------------------> 100.00%
Checksum <----------------------------------------------------------------------------------> 100.00%
*** ["Full Backup success summary"] *** [backup-checksum=3.597416ms] [backup-fast-checksum=2.36975ms] *** [total-take=4.715509333s] [BackupTS=435844546560000000] [total-kv=1131] [total-kv-size=250kB] [average-speed=53.02kB/s] [backup-data-size(after-compressed)=71.33kB] [Size=71330]
备份的相关参数
WXWorkLocalPro_17291589246828.png
查询快照备份的时间点信息
出于管理备份数的需要，如果你需要查看某个快照备份对应的快照物理时间点，可以执行下面的命令：
tiup br validate decode --field="end-version" \
--storage "s3://backup-101/snapshot-202209081330?access-key=${access-key}&secret-access-key=${secret-access-key}" | tail -n1
/app/tidb-community-toolkit-v8.1.1-linux-amd64/br validate decode --field="end-version" --storage "/backup/bk1" | tail -n1
WXWorkLocalPro_1729231416492.png
对集群进行快照恢复
注意
在 BR v7.5.0 及之前版本中，每个 TiKV 节点的快照恢复速度约为 100 MiB/s。
从 BR v7.6.0 开始，为了解决大规模 Region 场景下可能出现的恢复瓶颈问题，BR 支持通过粗粒度打散 Region 的算法加速恢复（实验特性）。可以通过指定命令行参数 --granularity="coarse-grained" 来启用此功能。
从 BR v8.0.0 版本开始，通过粗粒度打散 Region 算法进行快照恢复的功能正式 GA，并默认启用。通过采用粗粒度打散 Region 算法、批量创建库表、降低 SST 文件下载和 Ingest 操作之间的相互影响、加速表统计信息恢复等改进措施，快照恢复的速度有大幅提升。在实际案例中，快照恢复的 SST 文件下载速度最高提升约 10 倍，单个 TiKV 节点的数据恢复速度稳定在 1.2 GiB/s，端到端的恢复速度大约提升 1.5 到 3 倍，并且能够在 1 小时内完成对 100 TiB 数据的恢复。
如果你需要恢复备份的快照数据，则可以使用 tiup br restore full。该命令的详细使用帮助可以通过执行 tiup br restore full --help 查看。
将上文备份的快照数据恢复到目标集群：
tiup br restore full --pd "${PD_IP}:2379" \
--storage "s3://backup-101/snapshot-202209081330?access-key=${access-key}&secret-access-key=${secret-access-key}"
测试
./br restore full --pd "10.0.8.87:2379" --storage "/backup"
在恢复快照备份数据过程中，终端会显示恢复进度条。在完成恢复后，会输出恢复耗时、速度、恢复数据大小等信息。
Full Restore <------------------------------------------------------------------------------> 100.00%
*** ["Full Restore success summary"] *** [total-take=4.344617542s] [total-kv=5] [total-kv-size=327B
恢复备份数据中指定库表的数据
br 命令行工具支持只恢复备份数据中指定库、表的部分数据，该功能用于在恢复过程中过滤不需要的数据。
恢复单个数据库的数据
要将备份数据中的某个数据库恢复到集群中，可以使用 tiup br restore db 命令。以下示例只恢复 test 库的数据：
tiup br restore db \
--pd "${PD_IP}:2379" \
--db "test" \
--storage "s3://backup-101/snapshot-202209081330?access-key=${access-key}&secret-access-key=${secret-access-key}"
测试
./br restore db --db dba_test --pd "10.0.8.87:2379" --storage "/backup"
以上命令中 --db 选项指定了需要恢复的数据库名。
恢复单张表的数据
要将备份数据中的某张数据表恢复到集群中，可以使用 tiup br restore table 命令。以下示例只恢复 test.usertable 表的数据：
tiup br restore table --pd "${PD_IP}:2379" \
--db "test" \
--table "usertable" \
--storage "s3://backup-101/snapshot-202209081330?access-key=${access-key}&secret-access-key=${secret-access-key}"
测试
./br restore table --db dba_test --table t1 --pd "10.0.8.87:2379" --storage "/backup"
WXWorkLocalPro_17291570775706.png
以上命令中
--db 选项指定了需要恢复的数据库名，--table 选项指定了需要恢复的表名。
使用表库过滤功能恢复部分数据
要通过复杂的过滤条件恢复多个表，可以使用 tiup br restore full 命令，并用 --filter 或 -f 指定表库过滤的条件。以下示例恢复符合 db*.tbl* 条件的表的数据：
tiup br restore full \
--pd "${PD_IP}:2379" \
--filter 'db*.tbl*' \
--storage "s3://backup-101/snapshot-202209081330?access-key=${access-key}&secret-access-key=${secret-acce
注：filter 'db*.tbl*'的**号可有可无 备份无影响
测试
./br restore full --pd "10.0.8.87:2379" --filter 'dba_test.t1' --storage "/backup/bk3"
恢复 mysql 数据库下的表
-
brv5.1.0 开始，快照备份时默认自动备份 mysql schema 下的系统表数据，但恢复数据时默认不恢复系统表数据。 -
brv6.2.0 开始，增加恢复参数--with-sys-table支持恢复数据的同时恢复部分系统表相关数据。 -
brv7.6.0 开始，恢复参数--with-sys-table默认开启，即默认支持恢复数据的同时恢复部分系统表相关数据。
可恢复的部分系统表：
+----------------------------------+
| mysql.columns_priv |
| mysql.db |
| mysql.default_roles |
| mysql.global_grants |
| mysql.global_priv |
| mysql.role_edges |
| mysql.tables_priv |
| mysql.user |
| mysql.bind_info |
+----------------------------------+
不能恢复以下系统表：
+-----------------------------------------------------+
| capture_plan_baselines_blacklist |
| column_stats_usage |
| gc_delete_range |
| gc_delete_range_done |
| global_variables |
| stats_buckets |
| stats_extended |
| stats_feedback |
| stats_fm_sketch |
| stats_histograms |
| stats_history |
| stats_meta |
| stats_meta_history |
| stats_table_locked |
| stats_top_n |
| tidb |
+-----------------------------------------------------+
当恢复系统权限相关数据的时候，请注意：在恢复数据前 BR 会检查目标集群的系统表是否跟备份数据中的系统表兼容。这里的兼容是指满足以下所有条件：
- 目标集群需要存在备份中的系统权限表。
- 目标集群系统权限表列数需要与备份数据中一致，列的顺序可以有差异。
- 目标集群系统权限表的列需要与备份数据兼容。如果为带长度类型（包括整型、字符串等类型），前者长度需大于或等于后者，如果为
ENUM类型，则应该为后者超集。
