LOOKUP

LOOKUP根据索引遍历数据。用户可以使用LOOKUP实现如下功能：

  • 根据WHERE子句搜索特定数据。

  • 通过标签列出点: 检索指定标签的所有点ID。

  • 通过边类型列出边：检索指定边类型的所有边的起始点、目的点和rank。

  • 计数指定标签的点或指定边类型的边。

openCypher兼容性

本文操作仅适用于nGQL扩展。

前提条件

请确保LOOKUP语句有至少一个索引可用。如果需要创建索引，但是已经有相关的点、边或属性，用户必须在创建索引后重建索引，索引才能生效。

警告：正确使用索引可以加快查询速度，但是索引会导致写性能大幅降低（降低90%甚至更多）。请不要随意在生产环境中使用索引，除非很清楚使用索引对业务的影响。

语法

  1. LOOKUP ON {<vertex_tag> | <edge_type>} [WHERE <expression> [AND <expression> ...]] [YIELD <return_list>];
  3. <return_list>
  4.     <prop_name> [AS <col_alias>] [, <prop_name> [AS <prop_alias>] ...];

  • WHERE <expression>：指定遍历的过滤条件，还可以结合AND、OR一起使用。详情请参见WHERE。

  • YIELD <return_list>：指定要返回的结果和格式.

  • 如果只有WHERE子句，没有YIELD子句:

    • LOOKUP标签时，返回点ID。
    • LOOKUP边类型时，返回起始点ID、目的点ID和rank。

WHERE语句限制

在LOOKUP语句中使用WHERE子句，不支持如下操作：

  • $-和$^。
  • 在关系表达式中，不支持运算符两边都有字段名，例如tagName.prop1> tagName.prop2。
  • 不支持运算表达式和函数表达式中嵌套AliasProp表达式。
  • 不支持 starts with ends with contains 等字符串索引模糊查询操作
  • 不支持OR和XOR运算符。

检索点

返回标签为player且name为Tony Parker的点。

  1. nebula> CREATE TAG INDEX index_player ON player(name(30), age);
  3. nebula> REBUILD TAG INDEX index_player;
  4. +------------+
  5. | New Job Id |
  6. +------------+
  7. | 15         |
  8. +------------+
  10. nebula> LOOKUP ON player WHERE player.name == "Tony Parker";
  11. ============
  12. | VertexID |
  13. ============
  14. | 101      |
  15. ------------
  17. nebula> LOOKUP ON player WHERE player.name == "Tony Parker" \
  18.         YIELD player.name, player.age;
  19. =======================================
  20. | VertexID | player.name | player.age |
  21. =======================================
  22. | 101      | Tony Parker | 36         |
  23. ---------------------------------------
  25. nebula> LOOKUP ON player WHERE player.name == "Kobe Bryant" YIELD player.name AS name \
  26.         | GO FROM $-.VertexID OVER serve \
  27.         YIELD $-.name, serve.start_year, serve.end_year, $$.team.name;
  28. ==================================================================
  29. | $-.name     | serve.start_year | serve.end_year | $$.team.name |
  30. ==================================================================
  31. | Kobe Bryant | 1996             | 2016           | Lakers       |
  32. ------------------------------------------------------------------

检索边

返回边类型为follow且degree为90的边。

  1. nebula> CREATE EDGE INDEX index_follow ON follow(degree);
  3. nebula> REBUILD EDGE INDEX index_follow;
  4. +------------+
  5. | New Job Id |
  6. +------------+
  7. | 62         |
  8. +------------+
  10. nebula> LOOKUP ON follow WHERE follow.degree == 90;
  11. =============================
  12. | SrcVID | DstVID | Ranking |
  13. =============================
  14. | 100    | 106    | 0       |
  15. -----------------------------
  17. nebula> LOOKUP ON follow WHERE follow.degree == 90 YIELD follow.degree;
  18. =============================================
  19. | SrcVID | DstVID | Ranking | follow.degree |
  20. =============================================
  21. | 100    | 106    | 0       | 90            |
  22. ---------------------------------------------
  24. nebula> LOOKUP ON follow WHERE follow.degree == 60 YIELD follow.degree AS Degree \
  25.         | GO FROM $-.DstVID OVER serve \
  26.         YIELD $-.DstVID, serve.start_year, serve.end_year, $$.team.name;
  27. ================================================================
  28. | $-.DstVID | serve.start_year | serve.end_year | $$.team.name |
  29. ================================================================
  30. | 105       | 2010             | 2018           | Spurs        |
  31. ----------------------------------------------------------------
  32. | 105       | 2009             | 2010           | Cavaliers    |
  33. ----------------------------------------------------------------
  34. | 105       | 2018             | 2019           | Raptors      |
  35. ----------------------------------------------------------------

通过标签列出所有的对应的点/通过边类型列出边

如果需要通过标签列出所有的点，或通过边类型列出边，则标签、边类型或属性上必须有至少一个索引。

例如一个标签player有两个属性name和age，为了遍历所有包含标签player的点ID，标签player、属性name或属性age中必须有一个已经创建索引。

  • 查找所有标签为player的点 VID。

    1. nebula> CREATE TAG player(name string,age int);
    3. nebula> CREATE TAG INDEX player_index on player();
    5. nebula> REBUILD TAG INDEX player_index;
    6. +------------+
    7. | New Job Id |
    8. +------------+
    9. | 66         |
    10. +------------+
    12. nebula> INSERT VERTEX player(name,age) VALUES "player100":("Tim Duncan", 42), "player101":("Tony Parker", 36);
    14. # 列出所有的 player. 类似于 MATCH (n:player) RETURN id(n) /*, n */
    16. nebula> LOOKUP ON player;
    17. +-------------+
    18. | _vid        |
    19. +-------------+
    20. | "player100" |
    21. +-------------+
    22. | "player101" |
    23. +-------------+

  • 查找边类型为like的所有边的信息。

    1. nebula)> CREATE EDGE like(likeness int);
    3. nebula)> CREATE EDGE INDEX like_index on like();
    5. nebula> REBUILD EDGE INDEX like_index;
    6. +------------+
    7. | New Job Id |
    8. +------------+
    9. | 88         |
    10. +------------+
    12. nebula)> INSERT EDGE like(likeness) values "player100"->"player101":(95);
    14. # 列出所有的 like 边。类似于 MATCH (s)-[e:like]->(d) RETURN id(s), rank(e), id(d) /*, type(e) */
    16. nebula)> LOOKUP ON like;
    17. +-------------+----------+-------------+
    18. | _src        | _ranking | _dst        |
    19. +-------------+----------+-------------+
    20. | "player100" | 0        | "player101" |
    21. +-------------+----------+-------------+

统计点或边

统计标签为player的点和边类型为like的边。

  1. nebula> LOOKUP ON player | YIELD COUNT(*) AS Player_Number;
  2. +---------------+
  3. | Player_Number |
  4. +---------------+
  5. | 2             |
  6. +---------------+
  8. nebula> LOOKUP ON like | YIELD COUNT(*) AS Like_Number;
  9. +-------------+
  10. | Like_Number |
  11. +-------------+
  12. | 1           |
  13. +-------------+