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=valuelabel=(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

在回复中包含代表时间序列的元数据标签的所有标签-值对。如果没有指定 WITHLABELSSELECTED_LABELS,默认情况下,会报告一个空列表作为标签-值对。

SELECTED_LABELS label...(自 RedisTimeSeries v1.6 起)

返回代表时间序列的元数据标签的标签-值对的子集。当每个时间序列存在大量标签,但只需要其中一些标签的值时,可以使用。如果没有指定 WITHLABELSSELECTED_LABELS,默认情况下,会报告一个空列表作为标签-值对。

注意: 当在 Redis 集群上运行时,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

RedisTimeSeries


RATE THIS PAGE
Back to top ↑