tencent cloud

游戏数据库 TcaplusDB

产品动态
产品简介
产品概述
产品优势
应用场景
产品架构
地域介绍
购买指南
产品定价
欠费说明
快速入门
了解基本概念
创建集群
创建表格组
创建表格
获取连接信息
访问 TcaplusDB
操作指南
管理集群与表格组
管理表格
监控与告警
访问管理
标签
任务列表
使用 TcaplusDB client
使用 client 工具访问数据
client 工具命令参考
使用 TcaplusDB SDK
变更历史
SDK 下载
SDK for C++ 接口说明
TcaplusDB 错误码
SDK 安装
PB 表 C++SDK 操作方法
TDR 表 C++SDK 操作方法
使用 TcaplusDB RESTful API
RESTful API 接口说明
Go RESTful API 接口说明
Java RESTful API 接口说明
PHP RESTful API 接口说明
Python RESTful API 接口说明
RESTful API 各语言示例下载
实践教程
表结构设计
数据库交互
常见问题
信息咨询类
数据库使用类
数据库原理类
API 文档
History
Introduction
API Category
Making API Requests
Table Group APIs
Other APIs
Table APIs
Cluster APIs
Data Types
Error Codes
相关协议
服务等级协议
服务条款
词汇表
联系我们

setttl

PDF
聚焦模式
字号
最后更新时间: 2024-12-04 09:56:31

简介

用户可以通过调用 setttl 命令,为记录设置一个生存时间(Time To Live,TTL),记录的生存时间(精度为毫秒)在设置之后就会随着时间的流逝而不断地减少,当一个记录的生存时间被消耗殆尽时,TcaplusDB 就会移除这个记录。setttl 命令只针对单条记录生效,不支持针对多条记录的操作。

语法

setttl [table] ttl=[TTL] where key1 = 1 and key2 = "abc";

参数

参数
是否必填
限制条件
说明
table
表名
TTL
最大不能超过 uint64_t 最大值的一半,即 ttl 最大值为 ULONG_MAX/2,超过该值接口会强制设置为该值
生存时间,以毫秒为单位
where 条件中的 key
对于 tdr 表,必须填入所有 key 值
声明 key 的值,多个 key 值用 and 连接

错误

请参考 错误码列表

返回信息

情况描述
返回信息
记录不存在或者已过期
Record does not exist or has expired.
设置失败
Failed to set time to live. The error code is [error code] and the error message is [Error message].
设置成功
Set time to live successfully.

示例

设置2000毫秒的生存时间:
tcaplus> setttl mails ttl=2000 where key1 = 1 and key2 = "abc";
Set time to live successfully.

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈