写点什么

一文上手图数据备份恢复工具 NebulaGraph BR

作者:NebulaGraph
  • 2023-03-09
    浙江
  • 本文字数:3172 字

    阅读完需:约 10 分钟


作者:NebulaGraph 工程师 Kenshin


NebulaGraph BR 开源已经有一段时间了,为了给社区用户提供一个更稳、更快、更易用的备份恢复工具,去年对其进行了比较大的重构。NebulaGraph BR(以下简称 BR)分为社区版和企业版两个版本,企业版在社区版功能的基础上,额外提供了增量备份的能力。而本文将以 BR 社区版为例,简单介绍 BR 的一些实现细节并通过上手练习来讲述如何使用 BR 进行 NebulaGraph 数据的备份恢复。

什么是 BR

BR 即 Backup & Restore 的简称,是一款对 NebulaGraph 集群数据(包括元信息和数据信息)备份到远端,并利用备份数据对集群进行恢复的工具。仓库地址在此:https://github.com/vesoft-inc/nebula-br

什么是 NebulaGraph Agent

NebulaGraph Agent 是一个只关心本机的无状态的 RPC 服务,与 metad 通信,提供备份文件上传和下载、服务起停等接口供 BR 调用。在开始备份恢复前,需要确保集群的每个节点上部署了一个 agent,可以通过 SHOW HOSTS AGENT 查看 agent 的状态。仓库地址在此:https://github.com/vesoft-inc/nebula-agent


整体架构如下图所示:



由于 NebulaGraph Agent 分布在集群的各个节点上,在备份恢复时,BR 带来的 CPU 和网络 IO 开销会分散到各台机器上,使其可以轻松应对大规模集群的备份恢复场景。

上手 BR

为了能让大家更快的熟悉 BR 工具,让我们从零开始,做一个简单的实操练习,来体验目前 nebula-br 支持的所有功能。

环境准备

首先,我们需要创建一个 NebulaGraph 集群,目前 BR 工具不支持在容器场景执行备份恢复,可以通过下载安装包的方式在虚拟机上安装,参考文档:https://docs.nebula-graph.com.cn/3.3.0/2.quick-start/3.quick-start-on-premise/2.install-nebula-graph/


在集群创建完成后,可以通过 nebula-console(NebulaGraph 的命令行工具)来连接它。


执行下面的命令,为集群导入一个 basketballplayer 的数据集:


(root@nebula) [(none)]> :play basketballplayerStart loading dataset basketballplayer... Load dataset succeeded!
复制代码


在成功导入数据后,执行下面的命令来查看 basketballplayer 的点边统计


(root@nebula) [basketballplayer]> submit job stats+------------+| New Job Id |+------------+| 2          |+------------+... (root@nebula) [basketballplayer]> show stats+---------+------------+-------+| Type    | Name       | Count |+---------+------------+-------+| "Tag"   | "player"   | 51    || "Tag"   | "team"     | 30    || "Edge"  | "follow"   | 81    || "Edge"  | "serve"    | 152   || "Space" | "vertices" | 81    || "Space" | "edges"    | 233   |+---------+------------+-------+ ...
复制代码


接着,我们下载 BR 工具的二进制文件:


wget https://github.com/vesoft-inc/nebula-br/releases/download/v3.3.0/br-3.3.0-linux-amd64
复制代码

部署 NebulaGraph Agent 服务

在准备好集群环境后,需要在每台机器上安装并启动 NebulaGraph Agent 服务

1. 下载 NebulaGrpah Agent 二进制文件

wget https://github.com/vesoft-inc/nebula-agent/releases/download/v0.2.0/agent-0.2.0-linux-amd64
复制代码

2. 启动 nebula-agent

nohup ./agent-0.2.0-linux-amd64 --agent="<agent_node_ip>:8888" --meta="<metad_node_ip>:9559" > nebula_agent.log 2>&1 &
复制代码


该命令会启动一个监听 8888 端口的 nebula-agent 服务。--agent 的 port 可以自定义,--meta 的 ip、port 需要与集群 meta 保持一致。


可以在 nebula-console 中执行下面的命令查看 agent 的状态:


(root@nebula) [basketballplayer]> SHOW HOSTS AGENT+-----------------+------+----------+---------+--------------+---------+| Host            | Port | Status   | Role    | Git Info Sha | Version |+-----------------+------+----------+---------+--------------+---------+| "192.168.8.144" | 8888 | "ONLINE" | "AGENT" | "96646b8"    |         |+-----------------+------+----------+---------+--------------+---------+...
复制代码


当集群中所有 agent 都 online 后,我们可以执行备份恢复命令:

使用 BR 备份数据

BR 目前支持备份 NebulaGraph 集群的数据到本地或者 S3 上。为了方便练习,我们采用本地备份的方式,在生产环境,我们推荐用户将数据备份到 S3 上。备份命令如下:


./br-3.3.0-linux-amd64 backup full --meta "192.168.8.144:9559" --storage "local:///home/nebula/backup"
复制代码


该命令会对 Meta 服务的地址为 192.168.8.144:9559 的 NebulaGraph 集群进行全量备份,并将备份文件保存到本地的 /home/nebula/backup 目录下。

查看备份信息

备份完成后,我们可以通过下面的命令来查看备份信息:


./br-3.3.0-linux-amd64 show  --storage "local:///home/vesoft/backup"
+----------------------------+---------------------+------------------+-------------+------------+| NAME | CREATE TIME | SPACES | FULL BACKUP | ALL SPACES |+----------------------------+---------------------+------------------+-------------+------------+| BACKUP_2023_01_18_09_42_10 | 2023-01-18 17:42:10 | basketballplayer | true | true |+----------------------------+---------------------+------------------+-------------+------------+
复制代码

使用 BR 恢复数据

当集群数据出现问题时,我们可以使用 BR 基于之前备份的数据进行恢复。为了模拟数据丢失场景,可以执行下面的命令将 basketballplayer space 的数据清除。


(root@nebula) [basketballplayer]> DROP SPACE basketballplayer;Execution succeeded (time spent 2253/3002 us)...
复制代码


将 space 删除后,执行下面命令进行数据恢复。


./br-3.3.0-linux-amd64 restore full --meta "192.168.8.144:9559" --storage "local:///home/vesoft/backup" --name BACKUP_2023_01_18_09_42_10
复制代码


该命令会让 BR 从 /home/vesoft/backup/BACKUP_2023_01_18_09_42_10 读取备份数据,对 Meta 服务地址为 192.168.8.144:9559 的 NebulaGraph 集群进行恢复。


恢复完成后,我们可以通过 nebula-console 执行以下命令,查看恢复后的集群数据。理论上,此时的数据应该与备份之前的数据保持一致。


(root@nebula) [(none)]> use basketballplayer Execution succeeded (time spent 1130/1823 us)... (root@nebula) [basketballplayer]> submit job stats+------------+| New Job Id |+------------+| 3          |+------------+... (root@nebula) [basketballplayer]> show stats+---------+------------+-------+| Type    | Name       | Count |+---------+------------+-------+| "Tag"   | "player"   | 51    || "Tag"   | "team"     | 30    || "Edge"  | "follow"   | 81    || "Edge"  | "serve"    | 152   || "Space" | "vertices" | 81    || "Space" | "edges"    | 233   |+---------+------------+-------+ ...
复制代码

清理备份数据

在恢复完成后,我们可以执行下面的命令清理本次的备份数据。


./br-3.3.0-linux-amd64 cleanup  --meta "192.168.8.144:9559" --storage "local:///home/vesoft/backup" --name BACKUP_2023_01_18_09_42_10
复制代码


以上为本次 NebulaGraph 备份工具 nebula-br 的介绍。




谢谢你读完本文 (///▽///)


要来近距离体验一把 nebula-br 特性么?NebulaGraph 阿里云计算巢现 30 天免费使用中,点击链接来用用图数据库 NebulaGraph 和图数据备份 BR 吧~


想看 nebula-br 源码的小伙伴可以前往 GitHub 阅读、使用、(^з^)-☆ star 它 -> GitHub;和其他的 NebulaGraph 用户一起交流图数据库技术和应用技能,留下「你的名片」一起玩耍呢~

发布于: 刚刚阅读数: 4
用户头像

NebulaGraph

关注

一款开源的分布式图数据库 2020-04-28 加入

Follow me, here is my GitHub profile: https://github.com/vesoft-inc/nebula

评论

发布
暂无评论
一文上手图数据备份恢复工具 NebulaGraph BR_数据库_NebulaGraph_InfoQ写作社区