TS.ALTER

更新现有时间序列的保留、块大小、重复策略和标签

语法

TS.ALTER key [RETENTION retentionPeriod] [CHUNK SIZE size] [DUPLICATE POLICY ] [LABELS label value [label value ...]]

引入版本:1.0.0

复杂度摘要:O(N)

更新现有时间序列的保留、块大小、重复策略和标签

示例

必需参数

key

是时间序列的键名称。

Note: This command alters only the specified element. For example, if you specify only RETENTION and LABELS, the chunk size and the duplicate policy are not altered.

可选参数

RETENTION retentionPeriod

是与最大现有时间戳相比的最大保留期(以毫秒为单位)。请参阅 TS.CREATE 中的 RETENTION。

CHUNK_SIZE size

是每个新块的数据部分的初始分配大小(以字节为单位)。实际块可能会消耗更多内存。请参阅 TS.CREATE 中的 CHUNK_SIZE。更改此值不会影响现有块。

DUPLICATE_POLICY policy

是处理具有相同时间戳的多个样本的策略。请参阅 TS.CREATE 中的 DUPLICATE_POLICY。

LABELS [{label value}...]

是一组标签值对,代表键的元数据标签并用作二级索引。

如果指定了 LABELS,则应用给定的标签列表。给定列表中不存在的标签将被隐式删除。指定不带标签值对的 LABELS 将删除所有现有标签。请参阅 TS.CREATE 中的 LABELS。

示例

Alter a temperature time series

创建温度时间序列。

127.0.0.1:6379> TS.CREATE 温度:2:32 保留 60000 DUPLICATE_POLICY 最大标签sensor_id 2 area_id 32 OK

更改时间序列中的标签。

127.0.0.1:6379> TS.ALTER 温度:2:32 标签sensor_id 2 area_id 32 sub_area_id 15 OK

Redis Software 与 Redis Cloud 兼容性

Redis
软件
Redis
Cloud
说明
✅ 支持
✅ 灵活且每年一次
✅ 免费和固定

返回值

RESP2

以下之一: * 简单字符串回复:当时间序列更改成功时为 OK。 * 简单错误回复 在这些情况下:无效参数、错误的键类型、键不存在等。

RESP3

以下之一: * 简单字符串回复:当时间序列更改成功时为 OK。 * 简单错误回复 在这些情况下:无效参数、错误的键类型、键不存在等。

参见

TS.CREATE

Redis时间系列

资料来源:Redis 官方 TS.ALTER 文档;中文内容参考 Redis 文档许可。