• Fetch 语法
    • 获取点属性
      • 示例
    • 获取边属性
      • 获取边属性示例

    Fetch 语法

    FETCH 语句用于获取点和边的属性。

    获取点属性

    FETCH PROP ON 可返回节点的一系列属性，目前已支持一条语句返回多个节点属性。

    1. FETCH PROP ON <tag_name> <vertex_id_list> [YIELD [DISTINCT] <return_list>]

    <tag_name> 为标签名称，与 return_list 中的标签相同。

    <vertex_id_list>::=[vertex_id [, vertex_id]] 是一组用 “,” 分隔开的顶点 ID 列表

    [YIELD [DISTINCT] <return_list>] 为返回的属性列表，YIELD 语法参看 YIELD Syntax 。

    示例

    1. -- 如未指定 YIELD 字段，则返回节点 1 的所有属性
    2. nebula> FETCH PROP ON player 1
    3. -- 返回节点 1 的姓名与年龄属性
    4. nebula> FETCH PROP ON player 1 YIELD player.name, player.age
    5. -- 通过 hash 生成 int64 节点 ID，返回其姓名和年龄属性
    6. nebula> FETCH PROP ON player hash(\"nebula\")  YIELD player.name, player.age
    7. -- 沿边 e1 寻找节点 1 的所有近邻，返回其姓名和年龄属性
    8. nebula> GO FROM 1 over e1 YIELD e1._dst AS id | FETCH PROP ON player $-.id YIELD player.name, player.age
    9. -- 与上述语法相同
    10. nebula> $var = GO FROM 1 over e1 YIELD e1._dst AS id; FETCH PROP ON player $var.id YIELD player.name, player.age
    11. -- 获取 1，2，3 三个节点，返回姓名和年龄都不相同的记录
    12. nebula> FETCH PROP ON player 1,2,3 YIELD DISTINCT player.name, player.age

    获取边属性

    使用 FETCH 获取边属性的用法与点属性大致相同，且可同时获取相同类型多条边的属性。

    1. FETCH PROP ON <edge_type> <vid> -> <vid>@ranking [, <vid> -> <vid> ...] [YIELD [DISTINCT] <return_list>]

    <edge_type> 指定边的类型，需与 <return_list> 相同。

    <vid> -> <vid> 从起始节点到终止节点。多条边需使用逗号隔开。

    ranking 指定相同类型边 ranking，可选。

    [YIELD [DISTINCT] <return_list>] 为返回的属性列表。

    获取边属性示例

    1. -- 本语句未指定 YIELD，因此获取从节点 100 到节点 200 边 e1 的所有属性
    2. nebula> FETCH PROP ON e1 100 -> 200
    3. -- 仅返回属性 p1
    4. nebula> FETCH PROP ON e1 100 -> 200 YIELD e1.p1
    5. -- 获取节点 1 出边 e1 的 prop1 属性
    6. nebula> GO FROM 1 OVER e1 YIELD e1.prop1
    7. -- 同上述语句
    8. nebula> GO FROM 1 OVER e1 YIELD e1._src AS s, serve._dst AS d \
    9.  | FETCH PROP ON e1 $-.s -> $-.d YIELD e1.prop1
    10. -- 同上述语句
    11. nebula> $var = GO FROM 1 OVER e1 YIELD e1._src AS s, e2._dst AS d;\
    12.  FETCH PROP ON e3 $var.s -> $var.d YIELD e3.prop1