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_duration`为`0`，属性永不过期。可在配置文件`nebula-storaged.conf`（默认路径`/usr/local/nightly/etc/`）中设置`ttl_use_ms`为`true`将默认单位设为毫秒。

Caution

在设置ttl_use_ms为true前，请确保没有为属性设置 TTL，否则会因为过期时间缩短，导致数据被错误地删除。
在设置ttl_use_ms为true后，即设置ttl_duration的默认单位为毫秒后，ttl_col的默认单位仍然为秒，它的数据类型必须是int，并且需要手动转换属性值为毫秒。例如设置ttl_col为a，则需要将a的值转换为毫秒，如当a的值为now()，则需要将a的值设置为now() * 1000。

属性过期¶

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 TAG 和 CREATE 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_duration为0。本操作可以保留 TTL 选项，属性永不过期，且属性的 Schema 无法修改。
```
nebula> ALTER TAG t1 TTL_DURATION = 0;
```

最后更新: January 31, 2024