跳转至

TTL

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

openCypher 兼容性

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

注意事项

  • 不能修改带有 TTL 选项的属性的 Schema。
  • TTL 和 INDEX 共存问题:

    • 如果一个 Tag/Edge type 的其中一属性已有 INDEX,则不能为其设置 TTL,也不能为该 Tag 的其他属性设置 TTL。
    • 如果已有 TTL,可以再添加 INDEX。

TTL 选项

nGQL 支持的 TTL 选项如下。

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

属性过期

Caution

  • 当为一个 Tag 或 Edge type 的属性设置 TTL 并该属性的值为NULL时,TTL 功能不会生效,即该属性永不过期。
  • 如果为一个 Tag 或 Edge type 新增默认值为now()的属性并且该属性设置了 TTL,该 Tag 或 Edge type 相关的历史数据不会过期,因为历史数据的该属性值为当前时间戳。

点属性过期

点属性过期有如下影响:

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

边属性过期

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

过期处理

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

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

Note

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

使用 TTL 选项

Tag 或 Edge type 已存在

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

# 创建 Tag。
nebula> CREATE TAG IF NOT EXISTS t1 (a timestamp);

# ALTER 修改 Tag,添加 TTL 选项。
nebula> ALTER TAG t1 TTL_COL = "a", TTL_DURATION = 5;

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

Tag 或 Edge type 不存在

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

# 创建 Tag 并设置 TTL 选项。
nebula> CREATE TAG IF NOT EXISTS t2(a int, b int, c string) TTL_DURATION= 100, TTL_COL = "a";

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

删除存活时间

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

  • 删除设置存活时间的属性。
    nebula> ALTER TAG t1 DROP (a);
    
  • 设置ttl_col为空字符串。
    nebula> ALTER TAG t1 TTL_COL = "";
    
  • 设置ttl_duration0。本操作可以保留 TTL 选项,属性永不过期,且属性的 Schema 无法修改。
    nebula> ALTER TAG t1 TTL_DURATION = 0;
    

最后更新: September 4, 2023