使用 BR 恢复数据

如果使用 BR 备份了 Nebula Graph 的数据，可以通过备份文件进行数据恢复。本文介绍如何通过备份文件恢复数据。

Caution

恢复执行成功后，目标集群上已有的数据会被删除，然后替换为备份文件中的数据。建议提前备份目标集群上的数据。

Caution

数据恢复需要离线进行。

准备工作

• BR 编译完成。如何编译 BR，请参见编译 BR。

• 已下载 nebula-agent 并在集群中的每个主机上运行代理服务。

• 确认没有应用程序连接到待恢复数据的 Nebula Graph 集群。

• 确认集群的拓扑结构一致，即原集群和目标集群的主机数量一致，且每个主机数据文件夹数量分布一致。

操作步骤

1. 用户可以使用以下命令列出现有备份信息：

   $ ./bin/br show --storage <ip_address>
   

   例如，可以使用以下命令列出在本地 /home/nebula/backup 路径中的备份的信息。

   $ ./bin/br show --storage "local:///home/nebula/backup"
   +----------------------------+---------------------+------------------------+-------------+------------+
   |            NAME            |     CREATE TIME     |         SPACES         | FULL BACKUP | ALL SPACES |
   +----------------------------+---------------------+------------------------+-------------+------------+
   | BACKUP_2022_02_10_07_40_41 | 2022-02-10 07:40:41 | basketballplayer       | true        | true       |
   | BACKUP_2022_02_11_08_26_43 | 2022-02-11 08:26:47 | basketballplayer,foesa | true        | true       |
   +----------------------------+---------------------+------------------------+-------------+------------+
   

   或使用以下命令列出在兼容 s3 协议的对象存储服务 br-test 桶下的backup中的备份的信息。

   $ ./bin/br show --s3.endpoint "http://127.0.0.1:9000" --storage="s3://br-test/backup/" --s3.access_key=minioadmin --s3.secret_key=minioadmin --s3.region=default
   

   以下列出命令的相关参数。

   参数	数据类型	是否必需	默认值	说明
   -h,-help	-	否	无	查看帮助。
   --debug	-	否	无	查看更多日志信息。
   --log	string	否	"br.log"	日志路径。
   --storage	string	是	无	BR 备份数据存储位置，格式为：<Schema>://<PATH> Schema：可选值为 local 和 s3。选择 s3 时，需要填写s3.access_key、s3.endpoint、s3.region和 s3.secret_key。 PATH：存储位置的路径。
   --s3.access_key	string	否	无	用于标识用户。
   --s3.endpoint	string	否	无	S3 对外服务的访问域名的 URL，指定 http 或 https。
   --s3.region	string	否	无	数据中心所在物理位置。
   --s3.secret_key	string	否	无	用户用于加密签名字符串和用来验证签名字符串的密钥，必须保密。

2. 用户可以使用以下命令恢复数据：

   $ ./bin/br restore full --meta <ip_address> --storage <storage_path> --name <backup_name>
   

   例如，可以使用以下命令，将本地 /home/nebula/backup/ 路径中的数据恢复到为 meta 地址为127.0.0.1:9559集群中：

   $ ./bin/br restore full --meta "127.0.0.1:9559" --storage "local:///home/nebula/backup/" --name BACKUP_2021_12_08_18_38_08
   

   或者使用以下命令，将兼容 s3 协议的对象存储服务 br-test 桶下的backup的备份，恢复到 meta 服务的地址为127.0.0.1:9559的集群中。

   $ ./bin/br restore full --meta "127.0.0.1:9559" --s3.endpoint "http://127.0.0.1:9000" --storage="s3://br-test/backup/" --s3.access_key=minioadmin --s3.secret_key=minioadmin --s3.region="default" --name BACKUP_2021_12_08_18_38_08
   

   如果返回如下信息，表示数据已经恢复成功。

   Restore succeed.
   

   Caution

   如果用户新集群的IP和备份集群不同，在恢复集群后需要使用add host向新集群中添加 Storage 主机。

   以下列出命令的相关参数。

   参数	数据类型	是否必需	默认值	说明
   -h,-help	-	否	-	查看帮助。
   --debug	-	否	无	查看更多日志信息。
   --log	string	否	"br.log"	日志路径。
   --meta	string	是	无	meta 服务的地址和端口号。
   --name	string	是	无	备份名字。
   --storage	string	是	无	BR 备份数据存储位置，格式为：<Schema>://<PATH> Schema：可选值为 local 和 s3。选择 s3 时，需要填写s3.access_key、s3.endpoint、s3.region和 s3.secret_key。 PATH：存储位置的路径。
   --s3.access_key	string	否	无	用于标识用户。
   --s3.endpoint	string	否	无	S3 对外服务的访问域名的 URL，指定 http 或 https。
   --s3.region	string	否	无	数据中心所在物理位置。
   --s3.secret_key	string	否	无	用户用于加密签名字符串和用来验证签名字符串的密钥，必须保密。

3. 如果在备份期间发现任何错误，用户可以使用以下命令清理临时文件。该命令将清理集群和外部存储中的文件，同时用户也可以使用该命令清理外部存储中的旧的备份文件。

   $ ./bin/br cleanup --meta <ip_address> --storage <storage_path> --name <backup_name>
   

   以下列出命令的相关参数。

   参数	数据类型	是否必需	默认值	说明
   -h,-help	-	否	-	查看帮助。
   --debug	-	否	无	查看更多日志信息。
   --log	string	否	"br.log"	日志路径。
   --meta	string	是	无	meta 服务的地址和端口号。
   --name	string	是	无	备份名字。
   --storage	string	是	无	BR 备份数据存储位置，格式为：<Schema>://<PATH> Schema：可选值为 local 和 s3。选择 s3 时，需要填写s3.access_key、s3.endpoint、s3.region和 s3.secret_key。 PATH：存储位置的路径。
   --s3.access_key	string	否	无	用于标识用户。
   --s3.endpoint	string	否	无	S3 对外服务的访问域名的 URL，指定 http 或 https。
   --s3.region	string	否	无	数据中心所在物理位置。
   --s3.secret_key	string	否	无	用户用于加密签名字符串和用来验证签名字符串的密钥，必须保密。

---

最后更新: March 7, 2023