JanusGraph中Edge Index(VCI)与Relation Index的区别及创建方法咨询

1. Edge Index(VCI) 与 Relation Index 的核心区别 #

• 定位与适用场景
  • Edge Index(VCI，顶点中心索引)：是顶点依附型索引，专门优化从单个顶点出发的边遍历查询。比如查询某用户顶点的所有follow边、某商品顶点的所有review边且评分≥4的场景，VCI会把目标顶点的符合条件的边做局部索引，大幅提升单顶点边查询的效率。
  • Relation Index：是全局边索引，用于在全图范围内直接查询符合条件的边，不需要依附特定顶点。比如查询所有reportedBy标签且type为security的边，不管这些边连接的是哪个顶点，Relation Index可以直接定位结果，避免全图扫描。
• 存储与管理方式
  • VCI的索引数据和顶点关联存储（或绑定到顶点的存储分区），属于顶点的附属索引，只能通过顶点触发查询。
  • Relation Index是独立的全局索引结构，和顶点索引类似，存储在外部索引后端（比如你使用的Elasticsearch），支持跨顶点的边查询。
• 创建逻辑
  • VCI针对边标签+属性，绑定到顶点标签（或全局所有顶点）创建。
  • Relation Index直接针对边标签+属性创建全局索引，不需要关联顶点标签。

2. 如何创建 Edge Index(VCI) #

JanusGraph的顶点中心索引（VCI）通过管理API创建，支持两种方式：定义边标签时同步创建，或者对已存在的边标签添加VCI。

方式一：创建边标签时同步创建VCI #

// 打开管理事务
mgmt = graph.openManagement()

// 创建边属性（示例：type）
type = mgmt.makePropertyKey("type").dataType(String.class).make()

// 创建边标签
reportedBy = mgmt.makeEdgeLabel("reportedBy").multiplicity(MULTI).make()

// 为该边标签创建VCI，关联type属性，指定方向与排序
mgmt.buildEdgeIndex(reportedBy, "reportedByVCI", Direction.BOTH, Order.decr, type)

// 提交事务
mgmt.commit()

方式二：为已存在的边标签添加VCI #

mgmt = graph.openManagement()

// 获取已存在的边标签和属性
reportedBy = mgmt.getEdgeLabel("reportedBy")
type = mgmt.getPropertyKey("type")

// 创建VCI，指定方向（IN/OUT/BOTH）、排序和关联属性
mgmt.buildEdgeIndex(reportedBy, "reportedByVCI", Direction.OUT, Order.asc, type)

// 提交事务
mgmt.commit()
graph.tx().commit()

// 为已有边重新生成索引数据
mgmt = graph.openManagement()
mgmt.updateIndex(mgmt.getGraphIndex("reportedByVCI"), SchemaAction.REINDEX).get()
mgmt.commit()

注意事项：

• 创建VCI时必须指定方向（Direction.IN/OUT/BOTH），即索引该方向上的边。
• 如果创建VCI时图中已有对应边，必须执行REINDEX操作来为已有边生成索引数据。
• 同一边标签下的VCI名称需保持唯一。

内容的提问来源于stack exchange，提问作者Hari Krishnan Ramachandran