约束

概述

约束对图中的点、边的属性值施加限制规则。如果点、边的插入或更新操作与约束有冲突，将引发报错。

支持以下约束：

• NOT NULL
• EDGE KEY

显示约束

获取当前图集为点属性创建的所有约束：

SHOW NODE CONSTRAINT

获取当前图集为边属性创建的所有约束：

SHOW EDGE CONSTRAINT

约束信息展示在表_nodeConstraint和表 _edgeConstraint中，包含以下字段：

创建约束

你可以在创建图或定义图类型时创建约束，也可以在现有图中创建约束。以下示例展示如何使用语句ALTER NODE或ALTER EDGE在现有图中创建约束。这些情况下，约束创建以作业形式执行，稍后可使用SHOW JOB <id?>来验证是否创建成功。若需在创建图或图类型的同时创建约束，请阅读图。

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

NOT NULL

NOT NULL约束要求一个属性不可有null值。请留意，一个NOT NULL约束只能作用于一个Schema的一个属性。

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

ALTER NODE user ADD CONSTRAINT NOT NULL ON name

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

ALTER EDGE link ADD CONSTRAINT NOT NULL ON weight

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

EDGE KEY

一个EDGE KEY约束指定一个或多个边属性作为图中所有边的唯一标识符，确保它们没有null值或重复值。当指定多个属性时，也称为复合EDGE KEY约束。

详情

• 每个图只能创建一个EDGE KEY约束——单属性EDGE KEY或复合EDGE KEY。
• EDGE KEY无法应用到LIST类型的属性。
• EDGE KEY属性会自动缓存，以加速查询。
• 创建EDGE KEY时，要求每个Shard中属性值唯一，但允许不同Shard中存在重复值。但EDGE KEY创建完成后，所有的数据修改必须遵守全局唯一性。

单属性EDGE KEY

ALTER EDGE * ADD CONSTRAINT EDGE KEY ON eID INT32

成功创建这个EDGE KEY必须满足以下条件：

1. 所有边Schema均有eID属性，且类型为INT32。
2. eID没有null值或重复值。

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

ALTER EDGE * ADD CONSTRAINT EDGE KEY ON tag

本例中，所有边Schema必须包含STRING类型的tag属性。

复合EDGE KEY

ALTER EDGE * ADD CONSTRAINT EDGE KEY ON eID INT32, tag STRING

成功创建这个EDGE KEY必须满足以下条件：

1. 所有边Schema均有INT32类型的eID属性和STRING类型的tag属性。
2. eID和tag均没有null值
3. eID和tag的组合没有重复值。

使用IF NOT EXISTS

IF NOT EXISTS子句用于防止在尝试创建已存在的约束时出错，它允许安全地执行语句。

ALTER NODE user ADD CONSTRAINT IF NOT EXISTS NOT NULL ON name

仅当不存在user点的name属性的NOT NULL约束时，才会创建约束。如果已存在，则忽略该语句，不会引发报错。

删除约束

使用语句ALTER NODE或ALTER EDGE删除约束。

删除当前图的EDGE KEY约束：

ALTER EDGE * DROP EDGE KEY

删除user点的name属性的NOT NULL约束：

ALTER NODE user DROP CONSTRAINT NOT NULL ON name

对带有约束的属性限制

重命名属性

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

删除属性

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