概述

索引，即属性索引，是嬴图采用的一种技术，通过为点和边的指定属性创建索引来加速查询性能。数据库根据有索引的属性能够快速定位并获取数据。索引对大型数据集尤其有益，无需扫描全图即可优化对特定属性值的过滤。

索引类型

嬴图支持对单个属性应用单一索引，对同一schema下的多个属性应用复合索引。

显示索引

显示当前图集的索引信息：

// 显示所有索引
show().index() 

// 显示所有点索引
show().node_index()

// 显示所有边索引
show().edge_index()

索引信息展示在表_nodeIndex和_edgeIndex中。表中各字段提供了索引的基础信息：

创建索引

使用单个create()语句可创建一或多个索引。串联使用node_index()或edge_index()方法可指定每个索引。请注意，每个属性只能有一个索引。索引创建操作以作业形式进行，稍后可使用show().job(<id?>)确认索引是否成功创建。

为提升查询性能，嬴图中的系统属性已完成优化，具有内建效率。这些属性不支持创建索引。

create()
  .node_index(@<schema>.<property>(<bytes?>), "<indexName>")
  .edge_index(@<schema>.<property>(<bytes?>), "<indexName>")
  .node_index(@<schema>(<property1>(<bytes1?>), <property2>(<bytes2?>), ...), "<indexName>")
  .edge_index(@<schema>(<property1>(<bytes1?>), <property2>(<bytes2?>), ...), "<indexName>")
  ...

为card点属性balance创建名为cBalance的单一索引：

create().node_index(@card.balance, "cBalance")

为card点属性name（string类型）创建名为name的单一索引，并限制最大查询字符串长度为10：

create().node_index(@card.name(10), "name")

为transfer边属性amount和notes（text类型，限制最大查询字符串长度为10）创建名为transAmountNotes的复合索引：

create().edge_index(@transfer(amount, notes(10)), "transAmountNotes")

创建多个索引：

create()
  .node_index(@card.balance, "balance")
  .edge_index(@transfer(amount, notes(10)), "transAmountNotes")

删除索引

使用单个drop()语句可删除一或多个索引。串联使用node_index()或edge_index()方法可指定每个索引。删除索引不会影响存储在分片中的真实属性值。

拥有索引的属性无法被删除。删除属性需要先删除索引。

删除点索引cBalance：

drop().node_index("cBalance")

删除边索引transAmountNotes：

drop().edge_index("transAmountNotes")

删除多个索引：

drop().node_index("balance").edge_index("transAmountNotes")

使用索引

当查询过滤用到相关属性时，系统会自动应用索引，无需显式声明。

最左前缀原则

复合索引中属性的顺序非常重要：匹配到索引最左侧属性（即指定顺序里的首个属性或前几个属性）的查询会因此受益。

例如：

create().node_index(@user(name(10),age), 'name_age')

• find().nodes({@user.name == "Kavi" && @user.age > 20})使用了索引。
• find().nodes({@user.name == "Kavi"})使用了索引。
• find().nodes({@user.age > 20})未使用索引。
• find().nodes({@user.name == "Kavi" && @user.age > 20 && @user.grade == 7})使用了索引，同时包含对属性@user.grade的过滤，但该属性没有索引。

字符串大小限制

对于string或text类型属性的索引，需确保过滤器中使用字符串大小未超过指定上限。

例如，为user点的name属性创建索引Username，索引使用的大小限制为8字节：

create().node_index(@user.name(8), "Username")

以下查询不会使用索引Username，因为指定的字符串Aventurine超过了8字节的限制：

find().nodes({@user.name == "Aventurine"}) as n return n