tencent cloud

TencentDB for TcaplusDB

文档TencentDB for TcaplusDBTcaplusDB ClientClient Tool Commandssetttl

setttl

Download
聚焦模式
字号
最后更新时间： 2024-12-04 10:12:05

Overview

This command is used to set a time to live (TTL) in millisecond for a record. The set value will be reduced by the elapsed time. When the TTL value of a record is equal to 0, TcaplusDB will remove it. This command only takes effect on a single record.

Syntax

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

Parameters

Parameter
Required
Limit
Description
table
Yes
No
Table name
TTL
Yes
The value cannot exceed half of the maximum value of uint64\\_t. In other words, the maximum TTL value is ULONG_MAX/2. A value exceeded this limit will be set to the maximum value.
Time to live in millisecond
Key in the WHERE clause
Yes
All key values are required for TDR table.
Key values need to be declared. Multiple key values are joined with and.

Errors

For more information, see Error Codes.

Return Messages

Situation
Return Message
The record does not exist or has expired.
Record does not exist or has expired.
Failed to set time to live.
Failed to set time to live. The error code is [error code] and the error message is [Error message].
Set time to live successfully.
Set time to live successfully.

Sample

Set TTL to 2,000 milliseconds:
tcaplus> setttl mails ttl=2000 where key1 = 1 and key2 = "abc";
Set time to live successfully.
上一篇: getttl下一篇: dump

帮助和支持

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

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

文档反馈