TS.ALTER
语法
TS.ALTER key [RETENTION retentionPeriod] [CHUNK_SIZE size] [DUPLICATE_POLICY policy] [IGNORE ignoreMaxTimediff ignoreMaxValDiff] [LABELS [label value ...]]
- 在以下版本中可用
- Redis Stack / 时间序列 1.0.0
- 时间复杂度
- O(N),其中 N 是要更新的标签数量
更新现有时间序列的保留时间、块大小、重复策略和标签
必需参数
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
。
返回值
返回以下答复之一
- 简单字符串答复 - 如果执行正确,则返回
OK
- [] 发生错误时(无效参数、错误的键类型、键不存在等)
示例
更改温度时间序列
创建温度时间序列。
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