TTLGraph

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

openCypher 兼容性Graph

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

注意事项Graph

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

• TTL 和 INDEX 共存问题：

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

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

属性过期Graph

点属性过期Graph

点属性过期有如下影响：

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

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

边属性过期Graph

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

过期处理Graph

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

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

TTL 选项Graph

nGQL 支持的 TTL 选项如下。

使用 TTL 选项Graph

Tag 或 Edge type 已存在Graph

如果 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 不存在Graph

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

# 创建 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");

删除存活时间Graph

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

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

  nebula> ALTER TAG t1 DROP (a);
  

• 设置ttl_col为空字符串。

  nebula> ALTER TAG t1 ttl_col = "";
  

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

  nebula> ALTER TAG t1 ttl_duration = 0;