• CREATE TAG / EDGE 语法
    • Tag 名称和 Edge Type 名称
      • 属性名和数据类型
      • Time-to-Live (TTL) 语法
      • 示例

    CREATE TAG / EDGE 语法

    1. CREATE {TAG | EDGE} tag_name|edge_name
    2.     (create_definition, ...)
    3.     [tag_edge_options]
    5. create_definition:
    6.     prop_name data_type
    8. tag_edge_options:
    9.     option [, option ...]
    11. option:
    12.     TTL_DURATION [=] ttl_duration
    13.     | TTL_COL [=] prop_name

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

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

    Tag 名称和 Edge Type 名称

    • tag_name 和 edge_name

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

    属性名和数据类型

    • prop_name

      prop_name 表示每个属性的名称。在每个 tag 和 edgeType 中必须唯一。

    • data_type

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

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

    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 字段， Nebula Graph 会使用最早的失效时间。

    示例

    1. nebula> CREATE TAG course(name string, credits int)
    2. nebula> CREATE TAG notag()  -- 属性为空
    4. nebula> CREATE EDGE follow(start_time timestamp, likeness double)
    5. nebula> CREATE EDGE noedge()  -- 属性为空
    7. nebula> CREATE TAG woman(name string, age int,
    8.    married bool, salary double, create_time timestamp)
    9.    TTL_DURATION = 100, TTL_COL = create_time -- 过期时间是 100， 从当前时间开始
    11. nebula> CREATE EDGE marriage(location string, since timestamp)
    12.     TTL_DURATION = 0, TTL_COL = since -- 负值或 0 数据不会失效
    14. nebula> CREATE TAG icecream(made timestamp, temperature int)
    15.    TTL_DURATION = 100, TTL_COL = made,
    16.    TTL_DURATION = 10, TTL_COL = temperature
    17.    --  超过任一 TTL_DURATION 数据即失效
    19. nebula> CREATE EDGE garbage (thrown timestamp, temperature int)
    20.    TTL_DURATION = -2, TTL_COL = thrown,
    21.    TTL_DURATION = 10, TTL_COL = thrown
    22.    --  语法合法，但不推荐。数据将在 thrown + 10 后失效