YIELD

    YIELD可以引导子句或语句：

    • YIELD子句可以用于原生nGQL语句中，例如GO、FETCH或LOOKUP。

    • YIELD语句可以在独立查询或复合查询中使用。

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

    YIELD在nGQL和openCypher中有不同的函数：

    • Note

      nGQL不支持CALL[…YIELD]。

    • 在nGQL中，YIELD和openCypher中的RETURN类似。

    Note

    下文示例中的$$、$-等是引用符号，详情请参见。

      1. nebula> GO FROM "player100" OVER follow \
      2.         YIELD properties($$).name AS Friend, properties($$).age AS Age;
      3. +-----------------+-----+
      4. | Friend          | Age |
      5. +-----------------+-----+
      6. | "Tony Parker"   | 36  |
      7. | "Manu Ginobili" | 41  |
      8. +-----------------+-----+

    • FETCH语句中使用：

    • LOOKUP语句中使用YIELD：

      1. nebula> LOOKUP ON player WHERE player.name == "Tony Parker" \
      2. +-------------+-------------------------+------------------------+
      3. | VertexID    | properties(VERTEX).name | properties(VERTEX).age |
      4. +-------------+-------------------------+------------------------+
      5. | "player101" | "Tony Parker"           | 36                     |
      6. +-------------+-------------------------+------------------------+
    参数说明
    DISTINCT聚合输出结果，返回去重后的结果集。
    col要按返回的字段。如果没有为字段设置别名，返回结果中的列名为col。
    aliascol的别名。使用关键字AS进行设置，设置后返回结果中的列名为该别名。
    conditions在WHERE子句中设置的过滤条件。详情请参见WHERE。

    在中，YIELD语句可以接收、过滤、修改之前语句的结果集，然后输出。

    1. # 查找player100关注的player，并计算他们的平均年龄。
    2. nebula> GO FROM "player100" OVER follow \
    3.         YIELD dst(edge) AS ID \
    4.         | FETCH PROP ON player $-.ID \
    5.         YIELD properties(vertex).age AS Age \
    6.         | YIELD AVG($-.Age) as Avg_age, count(*)as Num_friends;
    7. +---------+-------------+
    8. | Avg_age | Num_friends |
    9. +---------+-------------+
    10. | 38.5    | 2           |
    11. +---------+-------------+

    YIELD可以计算表达式并返回结果。

    1. nebula> YIELD rand32(1, 6);
    3. | rand32(1,6) |
    4. +-------------+
    5. | 3           |
    6. +-------------+
    8. nebula> YIELD "Hel" + "\tlo" AS string1, ", World!" AS string2;
    9. | string1     | string2    |
    10. +-------------+------------+
    11. | "Hel    lo" | ", World!" |
    12. +-------------+------------+
    14. nebula> YIELD hash("Tim") % 100;
    15. +-----------------+
    16. | (hash(Tim)%100) |
    17. +-----------------+
    18. | 42              |
    19. +-----------------+
    21. nebula> YIELD \
    22.       CASE 2+3 \
    23.       WHEN 4 THEN 0 \
    24.       WHEN 5 THEN 1 \
    25.       ELSE -1 \
    26.       END \
    27.       AS result;
    28. +--------+
    29. | result |
    30. +--------+
    31. | 1      |
    32. +--------+