导入 SST 文件

    Nebula Graph 底层使用 RocksDB 作为键值型存储引擎。RocksDB 是基于磁盘的存储引擎,数据以 Sorted String Table(SSTable)格式存放。SSTable 是一个内部包含了任意长度、排好序的键值对 <key,value> 集合的文件,用于高效地存储大量的键值型数据。

    RocksDB 提供了一系列 API 用于创建及导入 SST 文件,有助于您快速导入海量数据。

    1. Exchange 的 Reader 从数据源中读取数据。

    2. sstProcessor 按照 Nebula Graph 要求的格式生成 SST 文件,存储到本地,并上传到 HDFS。SST 文件主要包含点和边两类数据,其中,

      • 表示点的键包括:分区信息、点 ID(VID)、标签类型信息和标签版本信息。
      • 表示边的键包括:分区信息、起点和终点 ID( 和 dst_vid)、边类型信息、边排序信息和边版本信息。
      • 对应的值主要包含各个属性键值对序列化信息。
    3. SstFileWriter 创建 SST 文件:Exchange 会创建一个 SstFileWriter 对象,然后打开一个文件并插入数据。生成 SST 文件时,行数据必须严格按照增序进行写入。

    4. 调用 IngestExternalFile() 方法时,RocksDB 默认会将文件拷贝到数据目录,并且阻塞 RocksDB 写入操作。如果 SST 文件中的键范围覆盖了 Memtable 键的范围,则将 Memtable 落盘(flush)到硬盘。将 SST 文件放置在 LSM 树最优位置后,为文件分配一个全局序列号,并打开写操作。

    使用示例

    不同来源的数据,导入 Nebula Graph 的操作与客户端形式导入操作基本相同,但是有以下差异:

    • 环境里必须部署 HDFS。
    • 在配置文件中,必须做以下修改:

      • 源数据的标签和边类型配置:tags.type.sinkedges.type.sink 必须配置为 sst
        1. # Nebula Graph 相关配置
        2. nebula: {
        3. address: {
        4. # 添加 Nebula Graph 数据库 Graph 服务的 IP 地址和端口
        5. graph: ["127.0.0.1:3699"]
        6. meta:["127.0.0.1:45500"]
        7. user: user
        8. pswd: password
        9. space: test
        10. path:{
        11. # 指定 SST 文件保存到本地的路径
        12. local:/Users/example/path
        13. # 指定上传 SST 文件的 HDFS 路径
        14. remote:/example/
        15. }
        16. connection {
        17. timeout: 3000
        18. retry: 3
        19. execution {
        20. }
        21. error: {
        22. max: 32
        23. output: /tmp/errors
        24. }
        25. rate: {
        26. limit: 64M
        27. timeout: 1000
        28. }

    详细描述请参考不同数据源的操作示例: