YIELD¶

YIELD定义 nGQL 查询的输出结果。

YIELD可以引导子句或语句：

YIELD子句用于原生 nGQL 语句中，例如GO、FETCH或LOOKUP，必须通过YIELD子句定义返回结果。

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

openCypher 兼容性¶

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

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

在 openCypher 中，YIELD用于在CALL[…YIELD]子句中指定过程调用的输出。

Note

nGQL 不支持CALL[…YIELD]。

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

Note

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

YIELD 子句¶

语法¶

ngql YIELD [DISTINCT] <col> [AS <alias>] [, <col> [AS <alias>] ...];

参数	说明
`DISTINCT`	聚合输出结果，返回去重后的结果集。
`col`	要返回的字段。如果没有为字段设置别名，返回结果中的列名为`col`。
`alias`	`col`的别名。使用关键字`AS`进行设置，设置后返回结果中的列名为该别名。

使用 YIELD 子句¶

GO语句中使用YIELD：
ngql nebula> GO FROM "player100" OVER follow \ YIELD properties($$).name AS Friend, properties($$).age AS Age; +-----------------+-----+ | Friend | Age | +-----------------+-----+ | "Tony Parker" | 36 | | "Manu Ginobili" | 41 | +-----------------+-----+

FETCH语句中使用YIELD：
ngql nebula> FETCH PROP ON player "player100" \ YIELD properties(vertex).name; +-------------------------+ | properties(VERTEX).name | +-------------------------+ | "Tim Duncan" | +-------------------------+

LOOKUP语句中使用YIELD：
ngql nebula> LOOKUP ON player WHERE player.name == "Tony Parker" \ YIELD properties(vertex).name, properties(vertex).age; +-------------------------+------------------------+ | properties(VERTEX).name | properties(VERTEX).age | +-------------------------+------------------------+ | "Tony Parker" | 36 | +-------------------------+------------------------+

YIELD 语句¶

语法¶

ngql YIELD [DISTINCT] <col> [AS <alias>] [, <col> [AS <alias>] ...] [WHERE <conditions>];

参数	说明
`DISTINCT`	聚合输出结果，返回去重后的结果集。
`col`	要按返回的字段。如果没有为字段设置别名，返回结果中的列名为`col`。
`alias`	`col`的别名。使用关键字`AS`进行设置，设置后返回结果中的列名为该别名。
`conditions`	在`WHERE`子句中设置的过滤条件。详情请参见 `WHERE`。

复合查询中使用 YIELD 语句¶

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

```ngql

查找 player100 关注的 player，并计算他们的平均年龄。¶

nebula> GO FROM "player100" OVER follow \ YIELD dst(edge) AS ID \ | FETCH PROP ON player $-.ID \ YIELD properties(vertex).age AS Age \ | YIELD AVG($-.Age) as Avg_age, count(*)as Num_friends; +---------+-------------+ | Avg_age | Num_friends | +---------+-------------+ | 38.5 | 2 | +---------+-------------+ ```

```ngql

查找 player101 关注的 player，返回 degree 大于 90 的 player。¶

nebula> $var1 = GO FROM "player101" OVER follow \ YIELD properties(edge).degree AS Degree, dst(edge) as ID; \ YIELD $var1.ID AS ID WHERE $var1.Degree > 90; +-------------+ | ID | +-------------+ | "player100" | | "player125" | +-------------+ ```

独立使用 YIELD 语句¶

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

```ngql nebula> YIELD rand32(1, 6); +-------------+ | rand32(1,6) | +-------------+ | 3 | +-------------+

nebula> YIELD hash("Tim") % 100; +-------------------+ | (hash("Tim")%100) | +-------------------+ | 42 | +-------------------+

nebula> YIELD \ CASE 2+3 \ WHEN 4 THEN 0 \ WHEN 5 THEN 1 \ ELSE -1 \ END \ AS result; +--------+ | result | +--------+ | 1 | +--------+ ```

最后更新: 2026年8月17日