LOOKUP

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

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

  • 通过Tag列出点：检索指定Tag的所有点ID。

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

  • 统计包含指定Tag的点或属于指定Edge type的边的数量。

OpenCypher兼容性

本文操作仅适用于原生nGQL。

注意事项

  • 索引会导致写性能大幅降低（降低90%甚至更多）。请不要随意在生产环境中使用索引，除非很清楚使用索引对业务的影响。

  • 如果用LOOKUP语句基于指定属性查询时该属性没有索引，系统会在可用的索引中随机选择一个。

    例如，Tag player 有属性 name 和 age，Tag player 本身和属性 name 有索引，而属性 age 没有索引。当运行 LOOKUP ON player WHERE player.age == 36 YIELD player.name; 时，系统会在 Tag player 和属性 name 的索引中随机使用一个。

    历史版本兼容性

    在此前的版本中，如果用LOOKUP语句基于指定属性查询时该属性没有索引，系统将报错，而不会使用其它索引。

前提条件

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

语法

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

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

  • YIELD：定义需要返回的输出。

    • LOOKUPTag时，除了返回定义的属性，额外返回VertexID。如果没有YIELD子句，返回VertexID。
    • LOOKUPEdge type时，除了返回定义的属性，额外返回起始点ID、目的点ID和rank。如果没有YIELD子句，返回起始点ID、目的点ID和rank。

  • AS：设置别名。

WHERE语句限制

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

  • $-和$^。
  • 在关系表达式中，不支持运算符两边都有字段名，例如tagName.prop1 > tagName.prop2。
  • 不支持运算表达式和函数表达式中嵌套AliasProp表达式。
  • 不支持XOR和NOT运算符。
  • 不支持除STARTS WITH之外的字符串操作。

检索点

返回Tag为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 \
  11.         WHERE player.name == "Tony Parker";
  12. +-------------+
  13. | VertexID    |
  14. +-------------+
  15. | "player101" |
  16. +-------------+
  18. nebula> LOOKUP ON player \
  19.         WHERE player.name == "Tony Parker" \
  20.         YIELD properties(vertex).name AS name, properties(vertex).age AS age;
  21. +-------------+---------------+-----+
  22. | VertexID    | name          | age |
  23. +-------------+---------------+-----+
  24. | "player101" | "Tony Parker" | 36  |
  25. +-------------+---------------+-----+
  27. nebula> LOOKUP ON player \
  28.         WHERE player.age  > 45;
  29. +-------------+
  30. | VertexID    |
  31. +-------------+
  32. | "player140" |
  33. | "player144" |
  34. +-------------+
  36. nebula> LOOKUP ON player \
  37.         WHERE player.name STARTS WITH "B" \
  38.         AND player.age IN [22,30] \
  39.         YIELD properties(vertex).name, properties(vertex).age;
  40. +-------------+-------------------------+------------------------+
  41. | VertexID    | properties(VERTEX).name | properties(VERTEX).age |
  42. +-------------+-------------------------+------------------------+
  43. | "player134" | "Blake Griffin"         | 30                     |
  44. | "player149" | "Ben Simmons"           | 22                     |
  45. +-------------+-------------------------+------------------------+
  47. nebula> LOOKUP ON player \
  48.         WHERE player.name == "Kobe Bryant"\
  49.         YIELD properties(vertex).name AS name |\
  50.         GO FROM $-.VertexID OVER serve \
  51.         YIELD $-.name, properties(edge).start_year, properties(edge).end_year, properties($$).name;
  52. +---------------+-----------------------------+---------------------------+---------------------+
  53. | $-.name       | properties(EDGE).start_year | properties(EDGE).end_year | properties($$).name |
  54. +---------------+-----------------------------+---------------------------+---------------------+
  55. | "Kobe Bryant" | 1996                        | 2016                      | "Lakers"            |
  56. +---------------+-----------------------------+---------------------------+---------------------+

检索边

返回Edge type为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 \
  11.         WHERE follow.degree == 90;
  12. +-------------+-------------+---------+
  13. | SrcVID      | DstVID      | Ranking |
  14. +-------------+-------------+---------+
  15. | "player150" | "player143" | 0       |
  16. | "player150" | "player137" | 0       |
  17. | "player148" | "player136" | 0       |
  18. ...
  20. nebula> LOOKUP ON follow \
  21.         WHERE follow.degree == 90 \
  22.         YIELD properties(edge).degree;
  23. +-------------+-------------+---------+-------------------------+
  24. | SrcVID      | DstVID      | Ranking | properties(EDGE).degree |
  25. +-------------+-------------+---------+-------------------------+
  26. | "player150" | "player143" | 0       | 90                      |
  27. | "player150" | "player137" | 0       | 90                      |
  28. | "player148" | "player136" | 0       | 90                      |
  29. ...
  31. nebula> LOOKUP ON follow \
  32.         WHERE follow.degree == 60 \
  33.         YIELD properties(edge).degree AS Degree |\
  34.         GO FROM $-.DstVID OVER serve \
  35.         YIELD $-.DstVID, properties(edge).start_year, properties(edge).end_year, properties($$).name;
  36. +-------------+------------------+----------------+--------------+
  37. | $-.DstVID   | serve.start_year | serve.end_year | $$.team.name |
  38. +-------------+------------------+----------------+--------------+
  39. | "player105" | 2010             | 2018           | "Spurs"      |
  40. | "player105" | 2009             | 2010           | "Cavaliers"  |
  41. | "player105" | 2018             | 2019           | "Raptors"    |
  42. +-------------+------------------+----------------+--------------+

通过Tag列出所有的对应的点/通过Edge type列出边

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

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

  • 查找所有Tag为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) \
    13.         VALUES "player100":("Tim Duncan", 42), "player101":("Tony Parker", 36);
    15. # 列出所有的 player。类似于 MATCH (n:player) RETURN id(n) /*, n */。
    17. nebula> LOOKUP ON player;
    18. +-------------+
    19. |  VertexID   |
    20. +-------------+
    21. | "player100" |
    22. | "player101" |
    23. +-------------+

  • 查找Edge type为follow的所有边的信息。

    1. nebula> CREATE EDGE follow(degree int);
    3. nebula> CREATE EDGE INDEX follow_index on follow();
    5. nebula> REBUILD EDGE INDEX follow_index;
    6. +------------+
    7. | New Job Id |
    8. +------------+
    9. | 88         |
    10. +------------+
    12. nebula> INSERT EDGE follow(degree) \
    13.         VALUES "player100"->"player101":(95);
    15. # 列出所有的 follow 边。类似于 MATCH (s)-[e:follow]->(d) RETURN id(s), rank(e), id(d) /*, type(e) */。
    17. nebula)> LOOKUP ON follow;
    18. +-------------+-------------+---------+
    19. | SrcVID      | DstVID      | Ranking |
    20. +-------------+-------------+---------+
    21. | "player100" | "player101" | 0       |
    22. +-------------+-------------+---------+

统计点或边

统计Tag为player的点和Edge type为follow的边。

  1. nebula> LOOKUP ON player |\
  2.         YIELD COUNT(*) AS Player_Number;
  3. +---------------+
  4. | Player_Number |
  5. +---------------+
  6. | 51            |
  7. +---------------+
  9. nebula> LOOKUP ON follow | \
  10.         YIELD COUNT(*) AS Follow_Number;
  11. +---------------+
  12. | Follow_Number |
  13. +---------------+
  14. | 81            |
  15. +---------------+

Note

使用SHOW STATS命令也可以统计点和边。

最后更新: November 1, 2021