CREATE EDGE 语法

CREATE EDGE [IF NOT EXISTS] <edge_name>
    ([<create_definition>, ...])
    [edge_options]
<create_definition> ::=
    <prop_name> <data_type>
<edge_options> ::=
    <option> [, <option> ...]
<option> ::=
    TTL_DURATION [=] <ttl_duration>
    | TTL_COL [=] <prop_name>
    | DEFAULT <default_value>

Nebula Graph 的图结构由带有属性的 tags 和 edges 组成。CREATE EDGE 使用一个给定的名称创建一个新的 edge type。

CREATE EDGE 语法有一些特点，在如下分块中将对这些特点进行讨论：

IF NOT EXISTS

创建 edge type 可使用 IF NOT EXISTS 关键字，这个关键字会自动检测对应的 edge type 是否存在，如果不存在则创建新的，如果存在则直接返回。

注意： 这里判断 edge type 是否存在只是比较 edge type 的名字(不包括属性)。

Edge Type 名称

• edge_name

  edge type 的名称在图中必须唯一，且名称被定义后无法被修改。edge type 的命名规则和 space 的命名规则一致。参见 Schema Object Name。

属性名和数据类型

• prop_name

  prop_name 表示每个属性的名称。在每个 edge type 中必须唯一。

• data_type

  data_type 表示每个属性的数据类型。更多关于 Nebula Graph 支持的数据类型信息请参见 data-type。

  NULL 和 NOT NULL 在创建 edge type 时不可用。(相比于关系型数据库)。

• 默认值约束

  您可以在创建 edge type 时使用 DEFAULT 约束设置属性的默认值。如果没有指定其他值，那么会将默认值插入新的边。默认值可以为 Nebula Graph 支持的任一数据类型，且支持表达式。如果您不想使用默认值，也可以写一个用户指定的值。

  暂时不支持使用 Alter 更改默认值。

Time-to-Live (TTL) 语法

• TTL_DURATION

  TTL_DURATION 指定了 vertices 和 edges 的有效期，超过有效期的数据会失效。失效时间为 TTL_COL 设置的属性值加 TTL_DURATION 设置的秒数。

  如果 TTL_DURATION 的值为负或 0，则该 edge 不会失效。

• TTL_COL

  指定的列（或者属性）必须是 int64 或者 timestamp。

• 单 TTL 定义

  仅支持指定单个 TTL_COL 字段。

TTL 详细用法参见 TTL 文档。

示例

nebula> CREATE EDGE follow(start_time timestamp, grade double);
nebula> CREATE EDGE noedge();  -- 属性为空
nebula> CREATE TAG player_with_default(name string, age int DEFAULT 20);  -- 默认年龄设置为 20 岁
nebula> CREATE EDGE follow_with_default(start_time timestamp DEFAULT 0, grade double DEFAULT 0.0);  -- 默认 start_time 设置为 0，默认 grade 设置为 0.0

nebula> CREATE EDGE marriage(location string, since timestamp)
    TTL_DURATION = 0, TTL_COL = "since"; -- 负值或 0 数据不会失效