Query by tagindex

docs-2.0/8.service-tuning/improve-query-by-tag-index.md

@@ -0,0 +1,54 @@
+# 增加和删除标签
+
+在openCypher中，有增加标签（`SET label`）和移除标签（`REMOVE label`）的功能，可以用于加速查询或者标记过程。
+
+在Nebula Graph中，可以通过Tag变相实现相同操作，创建Tag并将Tag插入到已有的点上，就可以根据Tag名称快速查找点，也可以通过`DELETE TAG`删除某些点上不再需要的Tag。
+
+!!! caution
+
+    请确保点上已经有另一个Tag，否则删除点上最后一个Tag时，会导致点也被删除。
+
+## 示例
+
+例如在basketballplayer数据集中，部分篮球运动员同时也是球队股东，可以为股东Tag`shareholder`创建索引，方便快速查找。如果不再是股东，可以通过`DELETE TAG`语句删除相应运动员的股东Tag。
+
+```ngql
+//创建股东Tag和索引
+nebula> CREATE TAG shareholder();
+nebula> CREATE TAG INDEX shareholder_tag on shareholder();
+
+//为点添加Tag
+nebula> INSERT VERTEX shareholder() VALUES "player100":();
+nebula> INSERT VERTEX shareholder() VALUES "player101":();
+
+//快速查询所有股东
+nebula> MATCH (v:shareholder) RETURN v;
++---------------------------------------------------------------------+
+| v                                                                   |
++---------------------------------------------------------------------+
+| ("player100" :player{age: 42, name: "Tim Duncan"} :shareholder{})  |
++---------------------------------------------------------------------+
+| ("player101" :player{age: 36, name: "Tony Parker"} :shareholder{}) |
++---------------------------------------------------------------------+
+nebula> LOOKUP ON shareholder;
++-------------+
+| VertexID    |
++-------------+
+| "player100" |
++-------------+
+| "player101" |
++-------------+
+
+//如果player100不再是股东
+nebula> DELETE TAG shareholder FROM "player100";
+nebula> LOOKUP ON shareholder;
++-------------+
+| VertexID    |
++-------------+
+| "player101" |
++-------------+
+```
+
+!!! note
+
+    如果插入测试数据后才创建索引，请用`REBUILD TAG INDEX <index_name_list>;`语句重建索引。

mkdocs.yml

@@ -310,6 +310,7 @@ nav:
       - 系统建模: 8.service-tuning/3.system-design.md
       - 执行计划: 8.service-tuning/4.plan.md
       - 超级节点(稠密点): 8.service-tuning/super-node.md
+      - 增加和删除标签: 8.service-tuning/improve-query-by-tag-index.md
 
   - 客户端:
     - 客户端介绍: 14.client/1.nebula-client.md