TTL

TTL（Time To Live）指定属性的存活时间，超时后，该属性就会过期。

openCypher兼容性

本文操作仅适用于原生nGQL。

注意事项

  • 不能修改带有TTL选项的属性的Schema。

  • TTL和INDEX共存问题：

    + 如果一个Tag的其中一属性已有INDEX，则不能为其设置TTL，也不能为该Tag的其他属性设置TTL。

    + 如果已有TTL，可以再添加INDEX。

属性过期

点属性过期

点属性过期有如下影响：

  • 如果一个点仅有一个Tag，点上的一个属性过期，点也会过期。

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

边属性过期

因为一条边仅有一个Edge type，边上的一个属性过期，边也会过期。

过期处理

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

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

Note

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

TTL选项

nGQL支持的TTL选项如下。

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

使用TTL选项

Tag或Edge type已存在

如果Tag和Edge type已经创建，请使用ALTER语句更新Tag或Edge type。

  1. # 创建Tag。
  2. nebula> CREATE TAG t1 (a timestamp);
  4. # ALTER修改Tag，添加TTL选项。
  5. nebula> ALTER TAG t1 ttl_col = "a", ttl_duration = 5;
  7. # 插入点，插入后5秒过期。
  8. nebula> INSERT VERTEX t1(a) values "101":(now());

Tag或Edge type不存在

创建Tag或Edge type时可以同时设置TTL选项。详情请参见CREATE TAG和CREATE EDGE。

  1. # 创建Tag并设置TTL选项。
  2. nebula> CREATE TAG t2(a int, b int, c string) ttl_duration= 100, ttl_col = "a";
  4. # 插入点。过期时间戳为1612778164774（1612778164674 + 100）。
  5. nebula> INSERT VERTEX t2(a, b, c) values "102":(1612778164674, 30, "Hello");

删除存活时间

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

  • 删除设置存活时间的属性。

    1. nebula> ALTER TAG t1 DROP (a);

  • 设置ttl_col为空字符串。

    1. nebula> ALTER TAG t1 ttl_col = "";

  • 设置ttl_duration为0。本操作可以保留TTL选项，属性永不过期，且属性的Schema无法修改。

    1. nebula> ALTER TAG t1 ttl_duration = 0;

最后更新: October 22, 2021