SPARQL-Gremlin插件是否支持JanusGraph？远程调用报错如何解决

问题原因 #

你触发报错的核心原因是SPARQL-Gremlin插件仅在你本地的Gremlin控制台激活，而你切换到了远程控制台模式，所有命令都会提交给远端的JanusGraph Server执行，但服务端并没有安装SPARQL-Gremlin依赖、也没有注册对应的类，因此找不到SparqlTraversalSource。

你本地测试TinkerGraph能成功，是因为TinkerGraph运行在本地Gremlin控制台进程内，可以直接读取到本地加载的插件类。

解决办法 #

方案1：服务端安装SPARQL-Gremlin插件（推荐用于生产环境） #

所有SPARQL翻译逻辑都在服务端执行，客户端不需要额外配置：

• 先停止运行中的JanusGraph服务
• 在JanusGraph安装目录执行安装命令，注意版本号要和当前JanusGraph依赖的TinkerPop版本完全匹配（比如JanusGraph 1.0.x对应TinkerPop 3.6.x，JanusGraph 0.6.x对应TinkerPop 3.5.x）：

  ./bin/janusgraph.sh install org.apache.tinkerpop sparql-gremlin <tinkerpop版本号>
  

• 修改服务端配置文件conf/gremlin-server/gremlin-server.yaml，在scriptEngines下的gremlin-groovy配置块的imports列表中加入：

  - org.apache.tinkerpop.gremlin.sparql.SparqlTraversalSource
  

  在staticImports列表中加入：

  - org.apache.tinkerpop.gremlin.sparql.__.sp
  

• 重启JanusGraph服务，之后再连接远程控制台就可以正常使用SPARQL查询能力。

方案2：本地翻译SPARQL再提交远程执行（适合调试场景） #

不需要修改服务端配置，所有SPARQL转Gremlin的逻辑都在本地完成，仅将翻译后的Gremlin遍历提交给服务端执行：

• 打开Gremlin控制台后先激活本地SPARQL插件：

  :plugin use tinkerpop.sparql
  

• 不要执行:remote console切换到远程命令模式，直接构造带远程连接的遍历源：

  g = traversal().withRemote('conf/remote.yaml')
  

• 直接调用sp()方法传入SPARQL语句执行即可：

  g.sp('SELECT * WHERE { ?s ?p ?o } LIMIT 10').toList()
  

注意事项 #

• SPARQL-Gremlin仅支持SPARQL 1.1的核心查询语法，不支持SPARQL更新语句、推理查询、联邦查询等高级特性。
• 涉及JanusGraph专属的复合索引、全文索引、范围索引等特性的查询，SPARQL自动翻译的Gremlin大概率无法命中索引，查询性能远低于原生手写的Gremlin，复杂业务查询建议直接使用Gremlin语法实现。

内容的提问来源于stack exchange，提问作者Xianyi Ye