如何在Windows 10部署NebulaGraph 2.5.0及配套Exchange？

一、基础组件版本要求（适配NebulaGraph 2.5.0） #

• Java：OpenJDK 8 或 Oracle JDK 8（必须为8版本，高版本存在兼容性问题）
• Scala：2.11.x（需与Spark版本匹配，Spark 2.4.x系列对应Scala 2.11）
• Spark：2.4.8（稳定适配版本，推荐选择带Hadoop 2.7的预编译包）

二、基础组件安装步骤 #

1. Java 8安装 #

• 下载对应Windows版本的JDK 8安装包，运行安装程序并选择安装路径（示例：C:\Program Files\Java\jdk1.8.0_301）
• 配置系统环境变量：
  • 新建JAVA_HOME变量，值为JDK安装路径
  • 编辑Path变量，添加%JAVA_HOME%\bin
• 验证：打开命令提示符，输入java -version，输出包含java version "1.8.0_xxx"即成功

2. Scala 2.11.x安装 #

• 下载Scala 2.11.12的Windows安装包，运行安装并选择路径（示例：C:\Program Files\Scala\scala-2.11.12）
• 配置系统环境变量：
  • 新建SCALA_HOME变量，值为Scala安装路径
  • 编辑Path变量，添加%SCALA_HOME%\bin
• 验证：命令行输入scala -version，输出包含Scala code runner version 2.11.12即成功

3. Spark 2.4.8安装 #

• 下载Spark 2.4.8预编译包（选择带Hadoop 2.7的版本），解压到本地路径（示例：C:\spark\spark-2.4.8-bin-hadoop2.7）
• 配置系统环境变量：
  • 新建SPARK_HOME变量，值为Spark解压路径
  • 编辑Path变量，添加%SPARK_HOME%\bin
• 验证：命令行输入spark-shell，成功进入Spark交互界面即完成安装

三、Exchange部署与配置 #

1. 获取Exchange安装包 #

下载适配NebulaGraph 2.5.0的Exchange jar包（nebula-exchange-2.5.0.jar），保存到本地目录（示例：C:\nebula-exchange）

2. 编写配置文件 #

在Exchange目录下创建application.conf配置文件，以下为CSV数据源的示例配置（可根据实际数据源调整）：

{
  # NebulaGraph连接配置
  nebula {
    address:{
      graph: ["127.0.0.1:9669"]
      meta: ["127.0.0.1:9559"]
    }
    user: "root"
    pswd: "nebula"
    space: "test_space"
    connection {
      timeout: 3000
      retry: 3
    }
    execution {
      retry: 3
    }
    error {
      max: 32
      output: "./error"
    }
    rate {
      limit: 1024
      timeout: 1000
    }
  }

  # CSV数据源配置
  dataSources {
    csv {
      path: "file:///C:/data/person.csv"
      label: "person"
      fields: [name, age]
      nebula.fields: [name, age]
      id: {
        type: "hash"
        fields: [name]
      }
      batch: 256
      partition: 3
    }
  }

  # Spark运行配置
  spark {
    app: {
      name: "Nebula Exchange 2.5.0"
    }
    driver: {
      cores: 1
      memory: "1g"
    }
    executor: {
      cores: 1
      memory: "1g"
    }
    cores {
      max: 1
    }
  }
}

3. 启动Exchange导入数据 #

打开命令提示符，进入Exchange所在目录，执行以下命令：

spark-submit --class com.vesoft.nebula.exchange.Exchange --master local[*] nebula-exchange-2.5.0.jar -c application.conf

• 说明：local[*]表示使用本地所有CPU核心运行，可根据机器配置调整；-c指定配置文件路径

四、常见问题排查 #

• Java版本不兼容：检查JAVA_HOME是否指向JDK8，重新验证java -version输出
• Spark启动失败：确认SPARK_HOME配置正确，解压包完整且Hadoop依赖适配Windows
• NebulaGraph连接失败：确认Nebula服务已启动，地址、端口、用户名密码与配置一致

内容的提问来源于stack exchange，提问作者Lisa Liu