跳转至

使用 BR 恢复数据

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

Caution

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

Caution

数据恢复需要离线进行。

准备工作

  • BR 编译完成。如何编译 BR,请参见编译 BR
  • 已下载 nebula-agent 并在集群中的每个主机上运行代理服务。
  • 确认没有应用程序连接到待恢复数据的 Nebula Graph 集群。
  • 确认集群的拓扑结构一致,即原集群和目标集群的主机数量一致,且每个主机数据文件夹数量分布一致。

操作步骤

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

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

    例如,可以使用以下命令列出在本地 /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:可选值为 locals3。选择 s3 时,需要填写s3.access_keys3.endpoints3.regions3.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:可选值为 locals3。选择 s3 时,需要填写s3.access_keys3.endpoints3.regions3.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:可选值为 locals3。选择 s3 时,需要填写s3.access_keys3.endpoints3.regions3.secret_key
    PATH:存储位置的路径。
    --s3.access_key string 用于标识用户。
    --s3.endpoint string S3 对外服务的访问域名的 URL,指定 http 或 https。
    --s3.region string 数据中心所在物理位置。
    --s3.secret_key string 用户用于加密签名字符串和用来验证签名字符串的密钥,必须保密。

最后更新: August 12, 2022