TS.ALTER
Syntax
TS.ALTER key [RETENTION retentionPeriod] [CHUNK_SIZE size] [DUPLICATE_POLICY policy] [IGNORE ignoreMaxTimediff ignoreMaxValDiff] [LABELS [label value ...]]
- Available in:
- Redis Stack / TimeSeries 1.0.0
- Time complexity:
- O(N) where N is the number of labels requested to update
更新现有时间序列的保留时间、块大小、重复策略和标签
必需的参数
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 [{label value}...]
是一组标签-值对,表示键的元数据标签,并作为二级索引。
如果指定了LABELS,则应用给定的标签列表。不在给定列表中的标签将被隐式删除。指定没有标签-值对的LABELS将删除所有现有标签。请参阅TS.CREATE中的LABELS。
返回值
返回以下回复之一:
- Simple string reply -
OK如果正确执行 - [] 出错时(无效参数、错误的键类型、键不存在等)
示例
Alter a temperature time series
创建一个温度时间序列。
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