跳转至

INSERT EDGE

INSERT EDGE语句可以在Nebula Graph实例的指定图空间中插入一条或多条边。边是有方向的,从起始点(src_vid)到目的点(dst_vid)。

INSERT EDGE的执行方式为覆盖式插入。如果已有Edge type、起点、终点、rank都相同的边,则覆盖原边。

语法

INSERT EDGE [IF NOT EXISTS] <edge_type> ( <prop_name_list> ) {VALUES | VALUE}
<src_vid> -> <dst_vid>[@<rank>] : ( <prop_value_list> )
[, <src_vid> -> <dst_vid>[@<rank>] : ( <prop_value_list> ), ...];

<prop_name_list> ::=
  [ <prop_name> [, <prop_name> ] ...]

<prop_value_list> ::=
  [ <prop_value> [, <prop_value> ] ...]
  • IF NOT EXISTS:用户可以使用IF NOT EXISTS关键字检测待插入的边是否存在,只有不存在时,才会插入。

    Note

    - IF NOT EXISTS 仅检测<边的类型、起始点、目的点和rank>是否存在,不会检测属性值是否重合。 - IF NOT EXISTS 会先读取一次数据是否存在,因此对性能会有明显影响。

  • <edge_type>:边关联的Edge type,只能指定一个Edge type。Edge type必须提前创建,详情请参见CREATE EDGE
  • <prop_name_list>:需要设置的属性名称列表。
  • src_vid:起始点ID,表示边的起点。
  • dst_vid:目的点ID,表示边的终点。
  • rank:可选项。边的rank值。默认值为0。rank值可以用来区分Edge type、起始点、目的点都相同的边。

    openCypher兼容性

    openCypher中没有rank的概念。

  • <prop_value_list>:根据prop_name_list填写属性值。如果属性值和Edge type中的数据类型不匹配,会返回错误。如果没有填写属性值,而Edge type中对应的属性设置为NOT NULL,也会返回错误。详情请参见CREATE EDGE

示例

# 插入不包含属性的边。
nebula> CREATE EDGE e1();                 
nebula> INSERT EDGE e1 () VALUES "10"->"11":();  

# 插入rank为1的边。
nebula> INSERT EDGE e1 () VALUES "10"->"11"@1:(); 
nebula> CREATE EDGE e2 (name string, age int); 
nebula> INSERT EDGE e2 (name, age) VALUES "11"->"13":("n1", 1);

# 一次插入2条边。
nebula> INSERT EDGE e2 (name, age) VALUES \
        "12"->"13":("n1", 1), "13"->"14":("n2", 2); 

# 创建失败,因为"a13"不是int类型。
nebula> INSERT EDGE e2 (name, age) VALUES "11"->"13":("n1", "a13");

一条边可以多次插入属性值,以最后一次为准。

# 多次插入属性值。
nebula> INSERT EDGE e2 (name, age) VALUES "11"->"13":("n1", 12);
nebula> INSERT EDGE e2 (name, age) VALUES "11"->"13":("n1", 13);
nebula> INSERT EDGE e2 (name, age) VALUES "11"->"13":("n1", 14);
nebula> FETCH PROP ON e2 "11"->"13";
+-------------------------------------------+
| edges_                                    |
+-------------------------------------------+
| [:e2 "11"->"13" @0 {age: 14, name: "n1"}] |
+-------------------------------------------+

使用IF NOT EXISTS插入已存在的边时,不会进行修改。

# 插入边。
nebula> INSERT EDGE e2 (name, age) VALUES "14"->"15"@1:("n1", 12);
# 使用IF NOT EXISTS修改边,因为边已存在,不会进行修改。
nebula> INSERT EDGE IF NOT EXISTS e2 (name, age) VALUES "14"->"15"@1:("n2", 13);
nebula> FETCH PROP ON e2 "14"->"15"@1;
+-------------------------------------------+
| edges_                                    |
+-------------------------------------------+
| [:e2 "14"->"15" @1 {age: 12, name: "n1"}] |
+-------------------------------------------+

Note

  • Nebula Graph 2.5.0 允许存在悬挂边(Dangling edge)。因此可以在起点或者终点存在前,先写边;此时就可以通过 <edgetype>._src<edgetype>._dst获取到(尚未写入的)点VID(不建议这样使用)。
  • 目前还不能保证操作的原子性,如果失败请重试,否则会发生部分写入。此时读取该数据的行为是未定义的。
  • 并发写入同一条边会报edge conflict错误,可稍后重试。
  • 边的INSERT速度大约是点的INSERT速度一半。原因是INSERT边会对应storaged的两个INSERT,INSERT点对应storaged的一个INSERT。

最后更新: July 2, 2021
Back to top