RETURN

    RETURN可以引导子句或语句：

    • RETURN子句可以用于nGQL中的openCypher方式语句中，例如MATCH或UNWIND。

    • RETURN可以单独使用，输出表达式的结果。

    本文操作仅适用于nGQL中的openCypher方式。关于原生nGQL如何定义输出结果，请参见YIELD。

    • 使用不在英文字母表中的字符作为变量名。例如：

    • 设置一个模式，并返回该模式匹配的所有元素。例如：

      1. MATCH (v:player) \
      2. RETURN (v)-[e]->(v2);

    历史版本兼容性

    • 在nGQL 1.x中，RETURN适用于原生nGQL，语法为RETURN <var_ref> IF <var_ref> IS NOT NULL。

    • 在nGQL 2.0中，RETURN不适用于原生nGQL。

    Map顺序说明

    1. nebula> RETURN {age: 32, name: "Marco Belinelli"};
    2. +------------------------------------+
    3. | {age:32,name:"Marco Belinelli"}    |
    4. +------------------------------------+
    5. | {age: 32, name: "Marco Belinelli"} |
    6. +------------------------------------+
    8. nebula> RETURN {zage: 32, name: "Marco Belinelli"};
    9. +-------------------------------------+
    10. | {zage:32,name:"Marco Belinelli"}    |
    11. +-------------------------------------+
    12. | {name: "Marco Belinelli", zage: 32} |
    13. +-------------------------------------+

    返回边

    1. nebula> MATCH (v:player)-[e]->() \
    2.         RETURN e;
    3. +------------------------------------------------------------------------------+
    4. | e                                                                            |
    5. +------------------------------------------------------------------------------+
    6. | [:follow "player104"->"player100" @0 {degree: 55}]                           |
    7. +------------------------------------------------------------------------------+
    8. | [:follow "player104"->"player101" @0 {degree: 50}]                           |
    9. +------------------------------------------------------------------------------+
    10. +------------------------------------------------------------------------------+
    11. | [:serve "player104"->"team200" @0 {end_year: 2009, start_year: 2007}]        |
    12. +------------------------------------------------------------------------------+
    13. | [:serve "player104"->"team208" @0 {end_year: 2016, start_year: 2015}]        |
    14. +------------------------------------------------------------------------------+

    返回属性

    使用语法{<vertex_name>|<edge_name>}.<property>返回点或边的属性。

    1. nebula> MATCH (v:player) \
    2.         RETURN v.name, v.age \
    3.         LIMIT 3;
    4. +-------------------+-------+
    5. | v.name            | v.age |
    6. +-------------------+-------+
    7. | "Rajon Rondo"     | 33    |
    8. +-------------------+-------+
    9. | "Rudy Gay"        | 32    |
    10. +-------------------+-------+
    11. | "Dejounte Murray" | 29    |
    12. +-------------------+-------+

    使用星号（*）返回匹配模式中的所有元素。

    重命名字段

    使用语法AS <alias>重命名输出结果中的字段。

    1. nebula> MATCH (v:player{name:"Tim Duncan"})-[:serve]->(v2) \
    2.         RETURN v2.name AS Team;
    3. +---------+
    4. | Team    |
    5. +---------+
    6. | "Spurs" |
    7. +---------+
    9. nebula> RETURN "Amber" AS Name;
    10. +---------+
    11. | Name    |
    12. +---------+
    13. | "Amber" |
    14. +---------+

    返回不存在的属性

    如果匹配的结果中，某个属性不存在，会返回NULL。

    1. nebula> MATCH (v:player{name:"Tim Duncan"})-[e]->(v2) \
    2.         RETURN v2.name, type(e), v2.age;
    3. +-----------------+----------+----------+
    4. | v2.name         | type(e)  | v2.age   |
    5. +-----------------+----------+----------+
    6. | "Tony Parker"   | "follow" | 36       |
    7. +-----------------+----------+----------+
    8. | "Manu Ginobili" | "follow" | 41       |
    9. +-----------------+----------+----------+
    10. +-----------------+----------+----------+

    返回唯一字段

    使用可以删除结果集中的重复字段。

    1. # 未使用DISTINCT。
    2. nebula> MATCH (v:player{name:"Tony Parker"})--(v2:player) \
    3.         RETURN v2.name, v2.age;
    4. +---------------------+--------+
    5. | v2.name             | v2.age |
    6. +---------------------+--------+
    7. | "Tim Duncan"        | 42     |
    8. +---------------------+--------+
    9. | "LaMarcus Aldridge" | 33     |
    10. +---------------------+--------+
    11. | "Marco Belinelli"   | 32     |
    12. +---------------------+--------+
    13. | "Boris Diaw"        | 36     |
    14. +---------------------+--------+
    15. | "Dejounte Murray"   | 29     |
    16. +---------------------+--------+
    17. | "Tim Duncan"        | 42     |
    18. +---------------------+--------+
    19. | "LaMarcus Aldridge" | 33     |
    20. +---------------------+--------+
    21. | "Manu Ginobili"     | 41     |
    22. +---------------------+--------+
    24. # 使用DISTINCT。
    25. nebula> MATCH (v:player{name:"Tony Parker"})--(v2:player) \
    26.         RETURN DISTINCT v2.name, v2.age;
    27. +---------------------+--------+
    28. | v2.name             | v2.age |
    29. +---------------------+--------+
    30. | "Tim Duncan"        | 42     |
    31. +---------------------+--------+
    32. | "LaMarcus Aldridge" | 33     |
    33. +---------------------+--------+
    34. | "Marco Belinelli"   | 32     |
    35. +---------------------+--------+
    36. | "Boris Diaw"        | 36     |
    37. +---------------------+--------+
    38. | "Dejounte Murray"   | 29     |
    39. +---------------------+--------+
    40. | "Manu Ginobili"     | 41     |