跳到主要内容
版本：3.10.0

NebulaGraph CPP

NebulaGraph CPP 是一款 C++ 语言的客户端，可以连接、管理 悦数图数据库 图数据库。

前提条件​

请确保已安装 C++ 且 GCC 版本为 4.8 及以上。

版本对照表​

参见Github。

安装 NebulaGraph CPP​

本文介绍通过编译方式安装 NebulaGraph CPP。

前提条件​

安装步骤​

  1. 克隆 NebulaGraph CPP 源码到机器。

  • （推荐）如果需要安装指定版本的 NebulaGraph CPP，请使用选项--branch指定分支。例如安装 v3.8.0发布版本，请执行如下命令：

    $ git clone --branch release-3.8 https://github.com/vesoft-inc/nebula-cpp.git

  • 如果需要安装日常开发版本，请执行如下命令下载master分支的源码：

    $ git clone https://github.com/vesoft-inc/nebula-cpp.git
  1. 进入目录 nebula-cpp。
$ cd nebula-cpp
  1. 创建目录 build 并进入该目录。
$ mkdir build && cd build
  1. 使用 CMake 生成 makefile 文件。
备注

默认安装路径为/usr/local/nebula，如果需要修改路径，请在下方命令内增加参数 -DCMAKE_INSTALL_PREFIX=<installation_path>。

$ cmake -DCMAKE_BUILD_TYPE=Release ..
备注

如果 g++ 不支持 C++11，请添加选项-DDISABLE_CXX11_ABI=ON。

  1. 编译 NebulaGraph CPP。

为了适当地加快编译速度，可以使用选项-j并行编译。并行数量N建议为min⁡(CPU核数，内存(GB)2)\min(\text{CPU}核数，\frac{内存 (GB)}{2})。

$ make -j{N}
  1. 安装 NebulaGraph CPP。
$ sudo make install
  1. 更新动态链接库。
$ sudo ldconfig

使用方法​

将 CPP 文件编译为可执行文件即可。接下来以SessionExample.cpp为例，介绍如何操作。

  1. 使用示例代码创建SessionExample.cpp文件。

  2. 编译文件，命令如下：

$ LIBRARY_PATH=<library_folder_path>:$LIBRARY_PATH g++ -std=c++11 SessionExample.cpp -I<include_folder_path> -lnebula_graph_client -o session_example

  • library_folder_path： 悦数图数据库 动态库文件存储路径，默认为/usr/local/nebula/lib64。

  • include_folder_path： 悦数图数据库 头文件存储路径，默认为/usr/local/nebula/include。

示例：

$ LIBRARY_PATH=/usr/local/nebula/lib64:$LIBRARY_PATH g++ -std=c++11 SessionExample.cpp -I/usr/local/nebula/include -lnebula_graph_client -o session_example

API 文档​

点击此处查看 CPP 客户端提供的各种类和方法。

核心代码​

NebulaGraph CPP 客户端提供 Session Pool 和 Connection Pool 两种方式连接 悦数图数据库 。使用 Connection Pool 需要用户自行管理 Session 实例。