概述

使用语句insert()可以向图集的一个schema插入新的点和边。

// 插入点
insert().into(<schema>).nodes([
  {<property1?>: <value1?>, <property2?>: <value2?>, ...},
  {<property1?>: <value1?>, <property2?>: <value2?>, ...},
  ...
])

// 插入边
insert().into(<schema>).edges([
  {_from: <fromValue>, _to: <toValue>, <property1?>: <value1?>, <property2?>: <value2?>, ...},
  {_from: <fromValue>, _to: <toValue>, <property1?>: <value1?>, <property2?>: <value2?>, ...},
  ...
])

属性规范列表中出现的每个属性都会被赋予给定的值，而缺失的自定义属性将默认赋值为null。

请注意：

• 点的_id值若未指定，将由系统自动生成；也可根据需要为其指定唯一值。
• 点和边的_uuid值由系统自动生成，不允许指定。
• 必须提供边属性_from和_to以指明边的起点和终点。

示例图集

在一个空图集中，逐行运行以下UQL语句，创建示例图集：

create().node_schema("user").edge_schema("follow")
create().node_property(@user, "name").node_property(@user, "age", int32).node_property(@user, "location", point).node_property(@user, "isBlocked", bool).node_property(@user, "permissionCodes", "set(uint32)").edge_property(@follow, "time", datetime)
insert().into(@user).nodes([{_id:"U001", name:"Jason", age:30}, {_id:"U002", name:"Tim"}, {_id:"U003", name:"Grace", age:25}, {_id:"U004", name:"Ted", age:26}])
insert().into(@follow).edges([{_from:"U004", _to:"U001", time:"2021-9-10"}, {_from:"U003", _to:"U001", time:"2020-3-12"}, {_from:"U004", _to:"U002", time:"2023-7-30"}])

插入单个点/边

向@user中插入一个点：

insert().into(@user).nodes({_id: "U005", name: "Alice"})

向@follow中插入一条边：

insert().into(@follow).edges({_from: "U002", _to: "U001", time: "2023-8-9"})

插入单个点或边时，可省略nodes()或edges()中的外层方括号[]。

插入多个点/边

向@user中插入三个点：

insert().into(@user).nodes([
  {_id: "U006", name: "Lee", age: 12},
  {name: "Alex"},
  {}
])

向@follow中插入两条边：

insert().into(@follow).edges([
  {_from: "U001", _to: "U002"},
  {_from: "U004", _to: "U003", time: "2023-9-10"}
])

返回插入的数据

向@follow中插入两条边并返回插入边的所有信息：

insert().into(@follow).edges([
  {_from: "U001", _to: "U004"},
  {_from: "U001", _to: "U003", time: "2022-2-7"}
]) as e
return e{*}

结果：e

提供布尔类型值

bool类型的属性只接受0（真）或1（假）两个值。如果提供其他值，都自动转换成0。

向@user中插入一个点，并为其属性isBlocked提供bool类型值：

insert().into(@user).nodes({isBlocked: 0})

提供Point类型值

使用point()函数为point类型属性指定属性值。

向@user中插入一个点，并为其属性location提供point类型值：

insert().into(@user).nodes([
  {location: point({latitude: 132.1, longitude: -1.5})}
]) as n
return n.location

结果：

提供列表类型值

向@user中插入一个点，并为其属性interests提供string[]类型值：

insert().into(@user).nodes([
  {interests: ["violin", "tennis", "movie"]}
])

提供集合类型值

向@user中插入一个点，并为其属性permissionCodes提供set(uint32)类型值：

insert().into(@user).nodes([
  {permissionCodes: [1002, 1002, 1003, 1004]}
]) as n
return n.permissionCodes

结果：

集合内的元素值会自动去重。