TS.MGET
TS.MGET [LATEST] [WITHLABELS | <SELECTED_LABELS label...>] FILTER filterExpr...
- 可用在
- Redis Stack / 时间序列 1.0.0
- 时间复杂度
- O(n),其中 n 是与过滤器匹配的时间序列数量。
获取与特定过滤器匹配的每个时间序列中具有最高时间戳的样本。
必需参数
FILTER filterExpr...
根据时间序列的标签和标签值过滤时间序列。每个过滤器表达式都具有以下语法之一:
label!=
- 时间序列具有名为label
的标签。label=value
- 时间序列具有名为label
的标签,其值为value
。label=(value1,value2,...)
- 时间序列具有名为label
的标签,其值为列表中的某个值。label=
- 时间序列没有名为label
的标签。label!=value
- 时间序列没有名为label
的标签,其值为value
。label!=(value1,value2,...)
- 时间序列没有名为label
的标签,其值为列表中的任何值。
- 至少需要一个语法为
label=value
或label=(value1,value2,...)
的过滤器表达式。 - 过滤器表达式是合取的。例如,过滤器
type=temperature room=study
表示时间序列是书房的温度时间序列。 - 除了值中的引号或双引号之间,过滤器表达式中不允许使用空格,例如,
x="y y"
或x='(y y,z z)'
。
可选参数
LATEST
(自 RedisTimeSeries v1.8 起)
在时间序列是压缩时使用。使用 LATEST
,TS.MGET 还会报告最新(可能为部分)存储桶的压缩值,前提是该存储桶的开始时间落在 [fromTimestamp, toTimestamp]
中。如果没有 LATEST
,TS.MGET 不会报告最新(可能为部分)存储桶。当时间序列不是压缩时,会忽略 LATEST
。
压缩的最新存储桶中的数据可能为部分数据。当一个新的样本到达并打开一个新的最新存储桶时,存储桶才会被关闭并压缩。但是,在某些情况下,也需要最新(可能为部分)存储桶的压缩值。在这种情况下,请使用 LATEST
。
WITHLABELS
在回复中包含代表时间序列的元数据标签的所有标签-值对。如果没有指定 WITHLABELS
或 SELECTED_LABELS
,默认情况下,会报告一个空列表作为标签-值对。
SELECTED_LABELS label...
(自 RedisTimeSeries v1.6 起)
返回代表时间序列的元数据标签的标签-值对的子集。当每个时间序列存在大量标签,但只需要其中一些标签的值时,可以使用。如果没有指定 WITHLABELS
或 SELECTED_LABELS
,默认情况下,会报告一个空列表作为标签-值对。
MGET
命令不能是事务的一部分。
返回值
- 数组回复:对于每个匹配指定过滤器的 时间序列,都会报告以下信息
示例
选择要检索的标签
为特拉维夫和耶路撒冷创建温度时间序列,然后添加不同的温度样本。
127.0.0.1:6379> TS.CREATE temp:TLV LABELS type temp location TLV
OK
127.0.0.1:6379> TS.CREATE temp:JLM LABELS type temp location JLM
OK
127.0.0.1:6379> TS.MADD temp:TLV 1000 30 temp:TLV 1010 35 temp:TLV 1020 9999 temp:TLV 1030 40
1) (integer) 1000
2) (integer) 1010
3) (integer) 1020
4) (integer) 1030
127.0.0.1:6379> TS.MADD temp:JLM 1005 30 temp:JLM 1015 35 temp:JLM 1025 9999 temp:JLM 1035 40
1) (integer) 1005
2) (integer) 1015
3) (integer) 1025
4) (integer) 1035
获取与最后一个样本关联的所有标签。
127.0.0.1:6379> TS.MGET WITHLABELS FILTER type=temp
1) 1) "temp:JLM"
2) 1) 1) "type"
2) "temp"
2) 1) "location"
2) "JLM"
3) 1) (integer) 1035
2) 40
2) 1) "temp:TLV"
2) 1) 1) "type"
2) "temp"
2) 1) "location"
2) "TLV"
3) 1) (integer) 1030
2) 40
要仅获取每个最后一个样本的 location
标签,请使用 SELECTED_LABELS
。
127.0.0.1:6379> TS.MGET SELECTED_LABELS location FILTER type=temp
1) 1) "temp:JLM"
2) 1) 1) "location"
2) "JLM"
3) 1) (integer) 1035
2) 40
2) 1) "temp:TLV"
2) 1) 1) "location"
2) "TLV"
3) 1) (integer) 1030
2) 40
另请参阅
TS.MRANGE
| TS.RANGE
| TS.MREVRANGE
| TS.REVRANGE