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
相关协议
服务等级协议
服务条款
词汇表
联系我们

getttl

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

简介

用户可以通过调用 getttl 命令,获取记录的生存时间(Time To Live,TTL),在为记录设置了生存时间之后,用户可以使用 getttl 命令查看键的剩余生存时间(精度为毫秒),即键还有多久才会因为过期而被移除。getttl 命令只针对单条记录生效,不支持针对多条记录的操作。

语法

getttl from [table] where key1 = 1 and key2 = "abc";

参数

参数
是否必填
限制条件
说明
table
表名
where 条件中的 key
对于 TDR 表,必须填入所有 key 值
声明 key 的值,多个 key 值用 and 连接

错误

请参考 错误码列表

返回信息

情况描述
返回信息
keys 不存在或者已过期
Record does not exist or has expired.
keys 存在并且没有设置过期时间(永久有效)
Record exists and no expiration time is set (permanent).
获取失败
Failed to get time to live. The error code is [error code] and the error message is [Error message].
获取成功
The time to live is [TTL] milliseconds.

示例

获取某条记录已经设置的生存时间:
tcaplus> getttl from mails where key1 = 1 and key2 = "abc";
The time to live is 2000 milliseconds.

帮助和支持

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

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

文档反馈