INSERT VERTEX

    执行INSERT VERTEX语句需要当前登录的用户拥有指定图空间的插入点权限，否则会报错。

    • IF NOT EXISTS：用户可以使用IF NOT EXISTS关键字检测待插入的VID是否存在，只有不存在时，才会插入，如果已经存在，不会进行修改。

      Note

      • IF NOT EXISTS 仅检测 VID + Tag 的值是否相同，不会检测属性值。
      • IF NOT EXISTS 会先读取一次数据是否存在，因此对性能会有明显影响。

    • prop_name_list：需要设置的属性名称列表。

    • VID：点ID。在Nebula Graph 2.0中支持字符串和整数，需要在创建图空间时设置，详情请参见。

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

    INSERT VERTEX与openCypher中CREATE的语意不同：

    • INSERT VERTEX语意更接近于NoSQL(key-value)方式的INSERT语意，或者SQL中的UPSERT (UPDATE or INSERT)。
    • 相同和TAG的情况下，如果没有使用IF NOT EXISTS，新写入的数据会覆盖旧数据，不存在时会新写入。
    • 相同VID但不同TAG的情况下，不同TAG对应的记录不会相互覆盖，不存在会新写入。

    参考以下示例。

    1. # 插入不包含属性的点。
    2. nebula> INSERT VERTEX t1() VALUE "10":();
    1. nebula> CREATE TAG t3(p1 int);
    2. nebula> CREATE TAG t4(p2 string);
    4. # 一次插入两个Tag的属性到同一个点。
    5. nebula> INSERT VERTEX  t3 (p1), t4(p2) VALUES "21": (321, "hello");

    一个点可以多次插入属性值，以最后一次为准。

    1. nebula> CREATE TAG t5(p1 fixed_string(5) NOT NULL, p2 int, p3 int DEFAULT NULL);
    2. nebula> INSERT VERTEX t5(p1, p2, p3) VALUES "001":("Abe", 2, 3);
    4. # 插入失败，因为属性p1不能为NULL。
    5. nebula> INSERT VERTEX t5(p1, p2, p3) VALUES "002":(NULL, 4, 5);
    8. # 属性p3为默认值NULL。
    9. nebula> FETCH PROP ON t5 "003";
    10. +--------------------------------------------+
    11. | vertices_                                  |
    12. +--------------------------------------------+
    13. | ("003" :t5{p1: "cd", p2: 5, p3: __NULL__}) |
    14. +--------------------------------------------+
    16. # 属性p1最大长度为5，因此会被截断。
    17. nebula> INSERT VERTEX t5(p1, p2) VALUES "004":("shalalalala", 4);
    18. nebula> FETCH PROP on t5 "004";
    19. +-----------------------------------------------+
    20. | vertices_                                     |
    21. +-----------------------------------------------+
    22. | ("004" :t5{p1: "shala", p2: 4, p3: __NULL__}) |