TcaplusDB Client - setttl命令
TcaplusDB Client的使用方法参见文档。
1. 功能说明
设置记录的生存时间（Time To Live，TTL，精度为毫秒）。
记录的生存时间在设置之后就会随着时间的流逝而不断地减少，当一个记录的生存时间被消耗殆尽时，系统就会删除这条记录。
getttl命令一次只能设置一条数据的剩余生存时间，不支持一次设置多条数据的剩余生存时间。
2. 启始版本
3.50.0
3. 命令语法
setttl [table] ttl=[TTL] where key1 = 1 and key2 = "abc";
参数说明：
| 参数 | 是否必填 | 限制条件 | 说明 |
|---|---|---|---|
| table | 是 | 无 | 表名 |
| key | 是 | 对于TDR表，必须填入所有主键字段的值 | 主键字段 |
| TTL | 是 | 最大不能超过uint64_t最大值的一半，即ttl最大值为 ULONG_MAX/2，超过该值接口会强制设置为该值 | 生存时间，以毫秒为单位 |
4. 命令示例
表定义详见示例表定义。
设置2000毫秒的记录生存时间。
tcaplus> setttl test_table ttl=2000 where gameid = 1 and itemid = 2 and name = "abc";
Set time to live successfully.
5. 常见错误
参考常见错误文档。
6. 相关文档
[TDR Generic表][C++ SDK]设置记录过期淘汰TTL接口说明。
[TDR Generic表][Go SDK]设置记录过期淘汰TTL接口说明。