跳转至

TTL

TTL(Time To Live)指定属性的存活时间,超时后,该属性就会过期。

openCypher兼容性

本文操作仅适用于nGQL扩展。

注意事项

  • 不能修改带有TTL选项的属性。
  • 标签或边类型上不能同时存在TTL选项和索引,即使在不同属性上分别设置也不行。

属性过期

点属性过期

点属性过期有如下影响:

  • 如果一个点仅有一个标签,点上的一个属性过期,点也会过期。
  • 如果一个点有多个标签,点上的一个属性过期,和该属性相同标签的其他属性也会过期,但是点不会过期,点上其他标签的属性保持不变。

边属性过期

因为一条边仅有一个边类型,边上的一个属性过期,边也会过期。

过期处理

属性过期后,对应的过期数据仍然存储在硬盘上,但是查询时会过滤过期数据。

Nebula Graph自动删除过期数据后,会在下一次Compaction过程中回收硬盘空间。

Note

如果关闭TTL选项,上一次Compaction之后的过期数据将可以被查询到。

TTL选项

nGQL支持的TTL选项如下。

选项 说明
ttl_col 指定要设置存活时间的属性。属性的数据类型必须是int或者timestamp
ttl_duration 指定时间戳差值,单位:秒。时间戳差值必须为64位非负整数。属性值和时间戳差值之和如果小于当前时间戳,属性就会过期。如果ttl_duration0,属性永不过期。

使用TTl选项

标签或边类型已存在

如果标签和边类型已经创建,请使用ALTER语句更新标签或边类型。

# 创建标签。
nebula> CREATE TAG t1 (a timestamp);

# ALTER修改标签,添加TTL选项。
nebula> ALTER TAG t1 ttl_col = "a", ttl_duration = 5;

# 插入点,插入后5秒过期。
nebula> INSERT VERTEX t1(a) values "101":(now());

标签或边类型不存在

创建标签或边类型时可以同时设置TTL选项。详情请参见CREATE TAGCREATE EDGE

# 创建标签并设置TTL选项。
nebula> CREATE TAG t2(a int, b int, c string) ttl_duration= 100, ttl_col = "a";

# 插入点。过期时间戳为1612778164774(1612778164674 + 100)。
nebula> INSERT VERTEX t2(a, b, c) values "102":(1612778164674, 30, "Hello");

删除存活时间

删除存活时间可以使用如下几种方法:

  • 删除设置存活时间的属性。
    nebula> ALTER TAG t1 DROP (a);
    
  • 设置ttl_col为空字符串。
    nebula> ALTER TAG t1 ttl_col = "";
    
  • 设置ttl_duration0。本操作可以保留TTL选项,同时防止属性过期。

    nebula> ALTER TAG t1 ttl_duration = 0;
    

    Danger

    即使ttl_duration0,用户也不能修改对应的属性。


最后更新: 2021年5月14日