约束

概述

约束对插入图集中的数据施加限制规则。如果数据修改操作与约束有冲突，将引发报错。

支持以下约束：

• EDGE KEY
• NOT NULL

创建约束

使用语句CREATE CONSTRAINT创建一条约束。约束创建以作业形式执行，稍后可使用show().job()来验证是否创建成功。

创建约束需要一些时间，因为系统需扫描全部现有数据，以确保其符合约束要求。如果现有数据与约束不符，则约束创建失败。此外，为确保数据一致性，创建约束时，会暂停其他数据修改操作。

EDGE KEY

EDGE KEY限制有效指定一条边属性为边的唯一标识符。因此，指定的边属性必须在所有边schema中以同一值类型出现，且必须在全图包含唯一非null值。

详情

• 每个图只能拥有一个EDGE KEY约束。
• EDGE KEY约束无法应用于list类型边属性。
• 与EDGE KEY约束相关的边属性会自动缓存，以加速查询。
• 将EDGE KEY约束应用于所有边schema时，必须使用*。
• 创建EDGE KEY约束时，强制要求每个分片中的属性值唯一，但允许不同分片中存在重复值。然而，EDGE KEY约束创建完成后，所有数据修改必须遵守全局唯一性。

为边属性createdOn创建名为eUID的EDGE KEY约束：

CREATE CONSTRAINT eUID
FOR ()-[e]-() REQUIRE e.createdOn IS EDGE KEY
OPTIONS {
  type: {createdOn: "datetime"}
}

若想成功创建该约束，必须满足以下条件：

1. 所有边schema均有名为createdOn的属性，其类型必须为datetime。
2. 各分片中，createdOn属性值必须唯一且不存在null值。

默认属性值类型

未指定属性值类型时，默认使用string：

CREATE CONSTRAINT eUID
FOR ()-[e]-() REQUIRE e.createdOn IS EDGE KEY

本例中，所有边schema必须包含string类型的createdOn边属性。

复合EDGE KEY约束

复合EDGE KEY约束涉及多个边属性。其创建要求与单属性EDGE KEY约束相同，但唯一性是基于指定属性的组合值强制执行的。

为边属性createdOn和weight创建名为eUIDs的复合EDGE KEY约束：

CREATE CONSTRAINT eUIDs
FOR ()-[e]-() REQUIRE (e.createdOn, e.weight) IS EDGE KEY
OPTIONS {
  type: {createdOn: "datetime", weight: "float"}
}

NOT NULL

NOT NULL约束强制要求一条属性不可拥有null值，确保属性永远存在非空值。

详情

• NOT NULL约束必须针对单个指定schema创建。
• 每个NOT NULL约束仅能指定一个属性。

为点user的name属性创建名为nn_1的NOT NULL约束：

CREATE CONSTRAINT nn_1
FOR (u:user) REQUIRE u.name IS NOT NULL

为边link的weight属性创建名为nn_2的NOT NULL约束：

CREATE CONSTRAINT nn_2
FOR ()-[e:link]-() REQUIRE e.weight IS NOT NULL

当指定属性不存在null值时，约束才能创建成功。

使用IF NOT EXISTS标志

图中的约束名称必须唯一。如果创建的约束与已有约束重名，创建操作将失败，并返回错误消息表明名称重复。

使用IF NOT EXISTS标志时，若在创建过程中检测到重复名称，作业将以FINISHED状态完成。不会返回错误信息，也不会创建新的约束。

创建名为nn_1的NOT NULL约束。如果约束名已存在，跳过创建过程，无需返回错误信息：

CREATE CONSTRAINT nn_1
FOR (u:user) REQUIRE u.age IS NOT NULL

命名规则

每个约束的名称需满足：

• 包含2~64个字符
• 以字母开头
• 允许的字符：字母（A-Z，a-z），字母（0-9），下划线（_）

图中约束不能重名。

显示约束

获取当前图集创建的所有约束：

// 显示所有约束
show().constraint()

// 显示为点属性创建的所有约束
show().node_constraint()

// 显示为边属性创建的所有约束
show().edge_constraint()

约束信息展示在表_nodeConstraint和表 _edgeConstraint中。表中各字段提供了每个约束的基础信息：

删除约束

使用语句DROP CONSTRAINT删除约束。

删除名为nn_1的约束：

DROP CONSTRAINT nn_1

使用IF EXISTS标志

如果指定的约束名称不存在，约束将删除失败，并返回错误信息。

使用IF EXISTS标志后，如果指定的约束名称不存在，不会返回错误信息，也不会删除约束。

删除名为nn的约束。若约束名称不存在，跳过删除过程，无需返回错误信息：

DROP CONSTRAINT nn_1 IF EXISTS

对带有约束的属性限制

重命名属性

应用了NOT NULL约束的属性可以重命名。但应用了EDGE KEY约束的属性不可重命名。

删除属性

应用了约束的属性无法删除，除非所有相关约束均已删除。