跳转至

NebulaGraph CPP

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

使用限制

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

版本对照表

NebulaGraph 版本 NebulaGraph CPP 版本
3.2.0 3.0.2
2.6.x 2.5.0
2.5.x 2.5.0
2.0.x 2.0.0

安装 NebulaGraph CPP

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

前提条件

安装步骤

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

    • (推荐)如果需要安装指定版本的 NebulaGraph CPP,请使用选项--branch指定分支。例如安装 v3.0.2发布版本,请执行如下命令:

      $ git clone --branch release-3.0 https://github.com/vesoft-inc/nebula-cpp.git
      
    • 如果需要安装日常开发版本,请执行如下命令下载master分支的源码:

      $ git clone https://github.com/vesoft-inc/nebula-cpp.git
      
  2. 进入目录 nebula-cpp。

    $ cd nebula-cpp
    
  3. 创建目录 build 并进入该目录。

    $ mkdir build && cd build
    
  4. 使用 CMake 生成 makefile 文件。

    Note

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

    $ cmake -DCMAKE_BUILD_TYPE=Release ..
    

    Note

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

  5. 编译 NebulaGraph CPP。

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

    $ make -j{N}
    
  6. 安装 NebulaGraph CPP。

    $ sudo make install
    
  7. 更新动态链接库。

    $ 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:NebulaGraph 动态库文件存储路径,默认为/usr/local/nebula/lib64
    • include_folder_path:NebulaGraph 头文件存储路径,默认为/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
    

核心代码

详细示例请参见 SessionExample


最后更新: February 3, 2023