TS.ALTER
语法
TS.ALTER key [RETENTION retentionPeriod] [CHUNK_SIZE size] [DUPLICATE_POLICY policy] [IGNORE ignoreMaxTimediff ignoreMaxValDiff] [LABELS [label value ...]]
- 可用版本
- Redis 开源版 / TimeSeries 1.0.0
- 时间复杂度
- O(N),其中 N 是请求更新的标签数量
- ACL 类别
-
@timeseries,@write,@slow,
更新现有时间序列的保留期、块大小、重复数据策略和标签
必需参数
key
是时间序列的 key 名称。
RETENTION 和 LABELS,块大小和重复数据策略不会被修改。
可选参数
RETENTION retentionPeriod
是以毫秒为单位的最大保留期,与现有最大时间戳相比。请参见 TS.CREATE 中的 RETENTION。
CHUNK_SIZE size
是每个新块数据部分的初始分配大小,单位为字节。实际块可能会消耗更多内存。请参见 TS.CREATE 中的 CHUNK_SIZE。更改此值不会影响现有块。
DUPLICATE_POLICY policy
是处理具有相同时间戳的多个采样点的策略。请参见 TS.CREATE 中的 DUPLICATE_POLICY。
IGNORE ignoreMaxTimediff ignoreMaxValDiff
是处理重复采样点的策略。请参见 TS.CREATE 中的 IGNORE。
LABELS [{标签 值}...]
是表示 key 的元数据标签的标签-值对集合,并用作辅助索引。
如果指定了 LABELS,则应用给定的标签列表。给定列表中不存在的标签将被隐式删除。指定不带标签-值对的 LABELS 会删除所有现有标签。请参见 TS.CREATE 中的 LABELS。
返回值
返回以下回复之一
- 简单字符串回复 - 如果执行成功则返回
OK - 出错时返回 [](参数无效、key 类型错误、key 不存在等)
示例
修改温度时间序列
创建一个温度时间序列。
127.0.0.1:6379> TS.CREATE temperature:2:32 RETENTION 60000 DUPLICATE_POLICY MAX LABELS sensor_id 2 area_id 32
OK修改时间序列中的标签。
127.0.0.1:6379> TS.ALTER temperature:2:32 LABELS sensor_id 2 area_id 32 sub_area_id 15
OK