使用 BR 命令行进行备份恢复
本文介绍如何 BR 命令行进行 TiDB 集群数据的备份和恢复。
在阅读本文前，请确保你已通读备份与恢复工具 BR 简介，尤其是使用限制和使用建议这两节。
BR 命令行描述
一条 br 命令是由子命令、选项和参数组成的。子命令即不带 - 或者 -- 的字符。选项即以 - 或者 -- 开头的字符。参数即子命令或选项字符后紧跟的、并传递给命令和选项的字符。
以下是一条完整的 br 命令行：
br backup full --pd "${PDIP}:2379" -s "s3://backup-data/2022-01-30/"
命令行各部分的解释如下：
backup：br的子命令full：backup的子命令-s或--storage：备份保存的路径"s3://backup-data/2022-01-30/"：-s的参数值，保存备份数据到 s3 的名为 backup-data 的 bucket 下面的2022-01-30/前缀目录下--pd：PD 服务地址"${PDIP}:2379"：--pd的参数
命令和子命令
BR 由多层命令组成。目前，BR 包含 backup 和 restore 两个子命令：
br backup用于备份 TiDB 集群br restore用于恢复 TiDB 集群
以上子命令可能还包含这些子命令：
full：可用于备份或恢复全部数据。db：可用于备份或恢复集群中的指定数据库。table：可用于备份或恢复集群指定数据库中的单张表。
常用选项
--pd：用于连接的选项，表示 PD 服务地址，例如"${PDIP}:2379"。-h/--help：获取所有命令和子命令的使用帮助。例如br backup --help。-V（或--version）：检查 BR 版本。--ca：指定 PEM 格式的受信任 CA 的证书文件路径。--cert：指定 PEM 格式的 SSL 证书文件路径。--key：指定 PEM 格式的 SSL 证书密钥文件路径。--status-addr：BR 向 Prometheus 提供统计数据的监听地址。
使用 BR 命令行备份集群示例
使用 br backup 命令来备份集群数据。可选择添加 full 或 table 子命令来指定备份的范围：全部集群数据或单张表的数据。
- 备份集群快照数据
- 备份单个数据库的数据
- 备份单张表的数据
- 使用表库过滤功能备份多张表的数据
- 备份数据到 Amazon S3 后端存储
- 备份数据到 Google GCS 后端存储
- 备份数据到 Azure Blob Storage 后端存储
- 增量备份
- 加密备份数据
使用 BR 命令行恢复集群数据示例
使用 br restore 命令来恢复备份数据。可选择添加 full、db 或 table 子命令来指定恢复操作的范围：全部集群数据、某个数据库或某张数据表。