[doc] TTL cn

docs/manual-CN/2.query-language/4.statement-syntax/1.data-definition-statements/TTL.md

@@ -1,79 +1,111 @@
 # TTL (time-to-live)
 
-借助 **TTL**，**Nebula Graph** 支持当数据过期后，在查询顶点和边时，会自动过滤掉过期的数据，过期的数据在 compaction 阶段会自动删除，不需要客户显式发出的 delete 操作。
+Nebula 支持 **TTL** ，在一定时间后或在特定时钟时间自动从数据库中删除点或者边。过期数据会在下次 compaction 时被删除，在下次 compaction 来临前，query 会过滤掉过期的点和边。
 
-`ttl_col` 用来指出 TTL 列，`ttl_duration` 用来指出 TTL 的持续时间，某一条数据的 TTL 列值加上 ttl_duration 值小于当前时间，则认为该条数据过期。`ttl_col` 列类型为 integer 或者 timestamp，单位为秒， `ttl_duration` 单位也是秒。
+ttl 功能需要 `ttl_col` 和 `ttl_duration` 一起使用。自从 `ttl_col` 指定的字段的值起，经过 `ttl_duration` 指定的秒数后，该条数据过期。即，到期阈值是 `ttl_col`指定的 property 的值加上 `ttl_duration` 设置的秒数。其中 `ttl_col` 指定的字段的类型需为 integer 或者 timestamp。
 
 ## TTL 配置
 
-TTL 值以秒为单位设置的。
+- `ttl_duration` 单位为秒，当 `ttl_duration` 被设置为 -1 或者 0，则点的此 tag 属性不会过期。
 
-- 如果设置 TTL，当某一行的 `ttl_col` 列值加上 `ttl_duration` 值小于当前时间时，则认为该条数据过期。
+- 当 `ttl_col` 指定的字段的值加上 `ttl_duration` 值小于当前时间时，该条数据过期。
 
-- 如果未设置 TTL 或 `ttl_col` 为空，则 TTL 不起作用。
+- 当该条数据有多个 tag，每个 tag 的 ttl 单独处理。
 
-- 如果 TTL 设置为 -1 或者 0，则此字段数据不会过期。
 
 ## 设置 TTL
 
-设置 TTL 可用来指定数据的存活时间。
-
-先创建 tag，然后增加 TTL 属性。
+* 对已经创建的 tag，设置 TTL。
 
 ```ngql
-nebula> CREATE TAG t(a int, b int, c string);
-nebula> ALTER TAG t ADD ttl_col = "a", ttl_duration = 1000; -- add ttl attribute
+nebula> CREATE TAG t(a timestamp, b int, c string);
+nebula> ALTER TAG t ttl_col = "a", ttl_duration = 100; -- 创建 ttl
 nebula> SHOW CREATE TAG t;
 ```
+点的 TAG t 属性会在 `a` 字段的值，经过 100s 后过期。
+
+* 在创建 tag 时设置 TTL。
+
+```ngql
+nebula> CREATE TAG t(a timestamp, b int, c string) ttl_duration= 100, ttl_col = "a";
+```
 
-或亦可在创建 tag 时设置 TTL 属性。
+```ngql
+nebula> CREATE TAG t1(a timestamp) ttl_duration= 5, ttl_col = "a";
+nebula> CREATE TAG t2(a timestamp) ttl_duration= 10, ttl_col = "a"
+nebula> INSERT VERTEX t1(a),t2(a) values 100:(now(), now()+15)
+```
+从 now() 起，5s 后，点 100 的 t1 属性值过期，20s 后，t2 属性值过期。
+
+当点有多个 tag 时
 
 ```ngql
-nebula> CREATE TAG t(a int, b int, c string) ttl_duration= 100, ttl_col = "a";
+nebula> CREATE TAG t3(a string)
+nebula> INSERT VERTEX t1(a),t3(a) values 200:(now(), "hello")
 ```
 
+5s 后, 点 Vertex 200 的 t1 属性过期。
+
+```ngql
+nebula> fetch prop on t1 200
+Execution succeeded (Time spent: 5.945/7.492 ms)
+
+
+nebula> fetch prop on t3 200
+======================
+| VertexID | t3.name |
+======================
+| 200      | hello   |
+----------------------
+```
+
+
 ## 删除 TTL
 
-如果为字段设置了 TTL 值，但又不希望数据自动过期，则可以删除该 TTL 属性，或者让 TTL 属性失效。例如，接着前面的示例。
+如果想要删除 TTL，可以 设置 `ttl_col` 字段为空，或删除配置的 `ttl_col` 字段，或者设置 `ttl_duration` 为 0 或者 -1。
 
-删除 TTL 属性：
 
 ```ngql
 nebula> ALTER TAG t ttl_col = ""; -- drop ttl attribute
 ```
 
-删除含有 TTL 属性的列：
+删除配置的 `ttl_col` 字段：
 
 ```ngql
 nebula> ALTER TAG t DROP a; -- drop field a with the ttl attribute
 ```
 
-让 TTL 属性失效：
+设置 ttl_duration 为 0 或者 -1：
 
 ```ngql
 nebula> ALTER TAG t ttl_duration = 0; -- keep the ttl but the data never expires
 ```
 
 ## TTL 使用注意事项
 
-- 如果字段包含 TTL，则不支持对该字段的更改操作。
+- 不能修改 `ttl_col` 所配置的字段。
 
 ``` ngql
-nebula> ALTER TAG t ADD ttl_col = "b", ttl_duration = 1000;
+nebula> ALTER TAG t ttl_col = "b", ttl_duration = 1000;
 nebula> ALTER TAG t CHANGE (b string); -- failed
 ```
 
-- 注意一个 tag 或 edge 不能同时拥有 TTL 和索引，只能二者择其一。
+- 注意一个 tag 或 edge 不能同时拥有 TTL 和索引，只能二者择其一，即使 `ttl_col` 配置的字段与要创建索引的字段不同。
 
 ``` ngql
 nebula> CREATE TAG t(a int, b int, c string) ttl_duration = 100, ttl_col = "a";
 nebula> CREATE TAG INDEX id1 ON t(a); -- failed
 ```
 
+``` ngql
+nebula> CREATE TAG t(a int, b int, c string) ttl_duration = 100, ttl_col = "a";
+nebula> CREATE TAG INDEX id1 ON t(b); -- failed
+```
+
 ```ngql
 nebula> CREATE TAG t1(a int, b int, c string);
 nebula> CREATE TAG INDEX id1 ON t1(a);
-nebula> ALTER TAG t1 ADD ttl_col = "a", ttl_duration = 100; -- failed
+nebula> ALTER TAG t1 ttl_col = "a", ttl_duration = 100; -- failed
 ```
 
-- edge 添加 TTL 与 tag 类似。
+- 对 edge 配置 TTL 与 tag 类似。