TS.ALTER
更新现有时间序列的保留、块大小、重复策略和标签
语法
TS.ALTER key [RETENTION retentionPeriod] [CHUNK SIZE size] [DUPLICATE POLICY ] [LABELS label value [label value ...]]
引入版本:1.0.0
复杂度摘要:O(N)
更新现有时间序列的保留、块大小、重复策略和标签
必需参数
key
是时间序列的键名称。
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。 * 简单错误回复 在这些情况下:无效参数、错误的键类型、键不存在等。
参见
相关主题
资料来源:Redis 官方 TS.ALTER 文档;中文内容参考 Redis 文档许可。