TTL (time-to-live)

    ttl 功能需要 和 ttl_duration 一起使用。自从 ttl_col 指定的字段的值起，经过 ttl_duration 指定的秒数后，该条数据过期。即，到期阈值是 ttl_col 指定的 property 的值加上 ttl_duration 设置的秒数。其中 ttl_col 指定的字段的类型需为 integer 或者 timestamp。

    • ttl_duration 单位为秒，范围为 0 ~ max(int64)，当 ttl_duration 被设置为 0，则点的此 tag 属性不会过期。

    • 当该条数据有多个 tag，每个 tag 的 ttl 单独处理。

    • 对已经创建的 tag，设置 TTL。

    点 101 的 TAG t1 属性会在 now() 之后，经过 5s 后过期。

    1. nebula> CREATE TAG t2(a int, b int, c string) ttl_duration= 100, ttl_col = "a";
    2. nebula> INSERT VERTEX t2(a, b, c) values 102:(1584441231, 30, "Word");
    • 当点有多个 TAG 时，各 TAG 的 TTL 相互独立。
    1. nebula> CREATE TAG t3(a string);
    2. nebula> INSERT VERTEX t1(a),t3(a) values 200:(now(), "hello");

    5s 后, 点 Vertex 200 的 t1 属性过期。

    如果想要删除 TTL，可以设置 ttl_col 字段为空，或删除配置的 ttl_col 字段，或者设置 ttl_duration 为 0。

    1. nebula> ALTER TAG t1 ttl_col = ""; -- drop ttl attribute;

    设置 ttl_duration 为 0：

    • 如果某个属性被 ttl_col 引用，则不支持对其进行更改操作。
    1. nebula> ALTER TAG t1 CHANGE (a string); -- failed
    • 注意一个 tag 或 edge 不能同时拥有 TTL 和索引，只能二者择其一，即使 ttl_col 配置的字段与要创建索引的字段不同。
    1. nebula> CREATE TAG t1(a int, b int, c string) ttl_duration = 100, ttl_col = "a";
    2. nebula> CREATE TAG INDEX id1 ON t1(a); -- failed
    1. nebula> CREATE TAG t1(a int, b int, c string);
    2. nebula> CREATE TAG INDEX id1 ON t1(a);
    3. nebula> ALTER TAG t1 ttl_col = "a", ttl_duration = 100; -- failed
    • 对 edge 配置 TTL 与 tag 类似。