nebulagraph exchange3.0.x

关注

原创最新推荐文章于 2026-06-25 11:56:40 发布 2.5k 阅读 AI 写同款· GEO 优化 ›

从实测出发，掌握 NebulaGraph Exchange 性能最大化的秘密 NebulaGraph Exchange 是图数据库 NebulaGraph 的一款数据处理工具，本篇内容从实测出发，教你如何用上、用好这个数据产品。阅读详情

文章目录

什么是 Nebula Exchange
版本系列
适用场景
产品优点
数据源
Q & A
exchange-spark2.4不能把hive表数据导入

什么是 Nebula Exchange

Nebula Exchange（简称 Exchange）是一款 Apache Spark™ 应用，用于在分布式环境中将集群中的数据批量迁移到 Nebula Graph 中，能支
持多种不同格式的批式数据和流式数据的迁移。
Exchange 由 Reader、Processor 和 Writer 三部分组成。Reader 读取不同来源的数据返回 DataFrame 后，Processor 遍历 DataFrame 的
每一行，根据配置文件中fields 的映射关系，按列名获取对应的值。在遍历指定批处理的行数后，Writer 会将获取的数据一次性写入到 Nebula
Graph 中。下图描述了 Exchange 完成数据转换和迁移的过程。

在这里插入图片描述

版本系列

Exchange 有社区版和企业版两个系列，二者功能不同。社区版在 GitHub 开源开发，企业版属于 Nebula Graph 企业套餐，详情参见版本对比

适用场景

Exchange 适用于以下场景：

需要将来自 Kafka、Pulsar 平台的流式数据，如日志文件、网购数据、游戏内玩家活动、社交网站信息、金融交易大厅或地理空间服务，以及来自
数据中心内所连接设备或仪器的遥测数据等转化为属性图的点或边数据，并导入 Nebula Graph 数据库。
需要从关系型数据库（如 MySQL）或者分布式文件系统（如 HDFS）中读取批式数据，如某个时间段内的数据，将它们转化为属性图的点或边数
据，并导入 Nebula Graph 数据库。
需要将大批量数据生成 Nebula Graph 能识别的 SST 文件，再导入 Nebula Graph 数据库。
需要导出 Nebula Graph 中保存的数据。

仅企业版 Exchange 支持从 Nebula Graph 中导出数据。

产品优点

适应性强：支持将多种不同格式或不同来源的数据导入 Nebula Graph 数据库，便于迁移数据。
支持导入 SST：支持将不同来源的数据转换为 SST 文件，用于数据导入。
支持 SSL 加密：支持在 Exchange 与 Nebula Graph 之间建立 SSL 加密传输通道，保障数据安全。
支持断点续传：导入数据时支持断点续传，有助于节省时间，提高数据导入效率。(目前仅迁移 Neo4j 数据时支持断点续传。)
异步操作：会在源数据中生成一条插入语句，发送给 Graph 服务，最后再执行插入操作。
灵活性强：支持同时导入多个 Tag 和 Edge type，不同 Tag 和 Edge type 可以是不同的数据来源或格式。
统计功能：使用 Apache Spark™ 中的累加器统计插入操作的成功和失败次数。
易于使用：采用 HOCON（Human-Optimized Config Object Notation）配置文件格式，具有面向对象风格，便于理解和操作。

数据源

Exchange 3.0.0 支持将以下格式或来源的数据转换为 Nebula Graph 能识别的点和边数据，然后通过 nGQL 语句的形式导入 Nebula Graph：

存储在 HDFS 或本地的数据：
Apache Parquet
Apache ORC
JSON
CSV
Apache HBase™
数据仓库：
Hive
MaxCompute
图数据库：Neo4j（Client 版本 2.4.5-M1）
关系型数据库：
MySQL
PostgreSQL
列式数据库：ClickHouse
流处理软件平台：Apache Kafka®
发布/订阅消息平台：Apache Pulsar 2.4.5

除了用 nGQL 语句的形式导入数据，Exchange 还支持将数据源的数据生成 SST 文件，然后通过 Console 导入 SST 文件。
此外，企业版 Exchange 支持以 Nebula Graph 为源，将数据导出到 CSV 文件。

Q & A

exchange-spark2.4不能把hive表数据导入

Q:
用exchange-spark2.4 最终编译为nebula-exchange_spark_2.4-3.0.0.jar

现在操作为从hive中导入到nebulagraph3.0遇到两问题
1 在用spark2.4.8 scala212导入时,应该是兼容问题不能成功导入
2 后来用spark.2.4.5 操作现在提示找不到hive中表,可以确认单独运行spark查询这张表是没有问题的
后又看3.0.2文档中有写加入-h true才能开启hive,但这个参数应该在最后加,加上后如下错误
在这里插入图片描述
A:
与文档一样操作编译jar

mvn clean package -Dmaven.test.skip=true -Dgpg.skip -Dmaven.javadoc.skip=true -pl nebula-exchange_spark_2.4 -am -Pscala-2.11 -Pspark-2.4

文档导入hive写的,需要参数hive支持
在这里插入图片描述
需要改变下参数写法

export SPARK_HOME=/opt/spark-2.4.5-211
$SPARK_HOME/bin/spark-submit \
--master yarn \
--deploy-mode client \
--class com.vesoft.nebula.exchange.Exchange \
--files /home/bigdata_tec/wsw/graph/application.conf \
/home/bigdata_tec/wsw/graph/nebula-exchange_spark_2.4-3.0.0.jar -c  /home/bigdata_tec/wsw/graph/application.conf -h

还有提示版本为Nebula Graph Exchange 2.0.0可能是个内部小bug