TS.雷夫兰奇

语法
TS.REVRANGE key fromTimestamp toTimestamp
  [LATEST]
  [FILTER_BY_TS ts...]
  [FILTER_BY_VALUE min max]
  [COUNT count]
  [[ALIGN align] AGGREGATION aggregator bucketDuration [BUCKETTIMESTAMP bt] [EMPTY]]
可用：
Redis 堆栈 / TimeSeries 1.4.0
时间复杂度：
O（n/m+k） 其中 n = 数据点数，m = 数据块大小（每个数据块的数据点），k = 请求范围内的数据点数

反向查询范围

例子

必需参数

key

是时间序列的键名称。

fromTimestamp

是范围查询的开始时间戳（整数 Unix 时间戳，以毫秒为单位）或表示时间序列中最早样本的时间戳。-

toTimestamp

是范围查询的结束时间戳（整数 Unix 时间戳，以毫秒为单位）或表示时间序列中最新样本的时间戳。+

注意：当时间序列是压缩时，最后一个压缩的值可能会聚合时间戳超出toTimestamp.那是因为toTimestamp仅限制压缩值的时间戳，即压缩的原始存储桶的开始时间。

可选参数

LATEST（自 RedisTimeSeries v1.8 起）

当时间序列为 compaction 时使用。跟LATEST、TS.REVRANGE 还会报告最新（可能是部分）存储桶的压缩值，前提是此存储桶的开始时间在[fromTimestamp, toTimestamp].没有LATEST、TS.REVRANGE 不报告最新的（可能是部分的）存储桶。当时间序列不是压缩时，LATEST被忽略。

压缩的最新存储桶中的数据可能是部分的。仅当新样品到达并打开最新的新存储桶时，存储桶才会关闭和压缩。但是，在某些情况下，还需要最新（可能是部分）存储桶的压缩值。在这种情况下，请使用LATEST.

FILTER_BY_TS ts...（自 RedisTimeSeries v1.6 起）

按特定时间戳列表筛选样本。如果指定了样本的确切时间戳并且介于[fromTimestamp, toTimestamp].

当与AGGREGATION：样本在聚合之前进行过滤。

FILTER_BY_VALUE min max（自 RedisTimeSeries v1.6 起）

按最小值和最大值筛选样本。

当与AGGREGATION：样本在聚合之前进行过滤。

COUNT count

在没有AGGREGATION：限制报告的样本数。

当与AGGREGATION：限制上报的 Bucket 数量。

ALIGN align（自 RedisTimeSeries v1.6 起）

是 的时间桶对齐控件AGGREGATION.它通过更改定义存储桶的引用时间戳来控制时间存储桶时间戳。 值包括：

  • start或：引用时间戳将是查询开始间隔时间 （-fromTimestamp），而-
  • end或 ：引用时间戳将是查询结束间隔时间 （+toTimestamp），而+
  • 特定时间戳：将引用时间戳与特定时间对齐

注意：如果未提供，则 alignment 设置为0.

AGGREGATION aggregator bucketDuration将样本聚合到时间桶中，其中：

  • aggregator采用以下聚合类型之一：

    aggregator 描述
    avg 所有值的算术平均值
    sum 所有值的总和
    min 最小值
    max 最大值
    range 最大值和最小值之间的差异
    count 值的数量
    first 存储桶中时间戳最低的值
    last 存储桶中时间戳最高的值
    std.p 值的总体标准差
    std.s 值的样本标准差
    var.p 值的总体方差
    var.s 值的样本方差
    twa 存储桶时间范围内的时间加权平均值（自 RedisTimeSeries v1.8 起）

  • bucketDuration是每个存储桶的持续时间（以毫秒为单位）。

没有ALIGN，存储桶启动时间是bucketDuration.

跟ALIGN align，存储桶启动时间是bucketDurationwith restder （余数）align % bucketDuration.

第一个存储桶启动时间小于或等于fromTimestamp.

[BUCKETTIMESTAMP bt]（自 RedisTimeSeries v1.8 起）

控制存储桶时间戳的报告方式。

bt 为每个存储桶报告的时间戳
-或start 存储桶的开始时间 （默认）
+或end 存储桶的结束时间
~或mid 存储桶的中间时间（如果不是整数，则向下舍入）
[EMPTY]（自 RedisTimeSeries v1.8 起）是一个标志，指定该标志后，还会报告空存储桶的聚合。
aggregator 为每个空存储桶报告的值
sum,count 0
last 存储桶开始前的最后一个样本的值。NaN当没有这样的样本。
twa 存储桶时间范围内的平均值，基于存储桶开始前的最后一个样本和存储桶结束之后的第一个样本的线性插值。NaN当没有这样的样本。
min,max,range,avg,first,std.p,std.s NaN

无论fromTimestamp和toTimestamp，则不会报告时间序列中最早样本之前结束或晚于最新样本的存储桶的数据。

返回值

返回以下回复之一：

复杂性

TS.将来可以通过使用二分搜索来查找范围的开头来提高 REVRANGE 复杂性，这使得O(Log(n/m)+k*m). 但是，因为m较小，则可以忽略它，将作视为O(Log(n)+k).

例子

按时间戳或样本值筛选结果

考虑一个指标，其中可接受的值介于 -100 和 100 之间，并且值 9999 用作测量不佳的指示。

127.0.0.1:6379> TS.CREATE temp:TLV LABELS type temp location TLV
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

Now, retrieve all values except out-of-range values.

TS.REVRANGE temp:TLV - + FILTER_BY_VALUE -100 100
1) 1) (integer) 1030
   2) 40
2) 1) (integer) 1010
   2) 35
3) 1) (integer) 1000
   2) 30

Now, retrieve the average value, while ignoring out-of-range values.

TS.REVRANGE temp:TLV - + FILTER_BY_VALUE -100 100 AGGREGATION avg 1000
1) 1) (integer) 1000
   2) 35
Align aggregation buckets

To demonstrate alignment, let’s create a stock and add prices at three different timestamps.

127.0.0.1:6379> TS.CREATE stock:A LABELS type stock name A
OK
127.0.0.1:6379> TS.MADD stock:A 1000 100 stock:A 1010 110 stock:A 1020 120
1) (integer) 1000
2) (integer) 1010
3) (integer) 1020
127.0.0.1:6379> TS.MADD stock:A 2000 200 stock:A 2010 210 stock:A 2020 220
1) (integer) 2000
2) (integer) 2010
3) (integer) 2020
127.0.0.1:6379> TS.MADD stock:A 3000 300 stock:A 3010 310 stock:A 3020 320
1) (integer) 3000
2) (integer) 3010
3) (integer) 3020

Next, aggregate without using ALIGN, defaulting to alignment 0.

127.0.0.1:6379> TS.REVRANGE stock:A - + AGGREGATION min 20
1) 1) (integer) 3020
   2) 320
2) 1) (integer) 3000
   2) 300
3) 1) (integer) 2020
   2) 220
4) 1) (integer) 2000
   2) 200
5) 1) (integer) 1020
   2) 120
6) 1) (integer) 1000
   2) 100

And now set ALIGN to 10 to have a bucket start at time 10, and align all the buckets with a 20 milliseconds duration.

127.0.0.1:6379> TS.REVRANGE stock:A - + ALIGN 10 AGGREGATION min 20
1) 1) (integer) 3010
   2) 310
2) 1) (integer) 2990
   2) 300
3) 1) (integer) 2010
   2) 210
4) 1) (integer) 1990
   2) 200
5) 1) (integer) 1010
   2) 110
6) 1) (integer) 990
   2) 100

When the start timestamp for the range query is explicitly stated (not -), you can set ALIGN to that time by setting align to - or to start.

127.0.0.1:6379> TS.REVRANGE stock:A 5 + ALIGN - AGGREGATION min 20
1) 1) (integer) 3005
   2) 310
2) 1) (integer) 2985
   2) 300
3) 1) (integer) 2005
   2) 210
4) 1) (integer) 1985
   2) 200
5) 1) (integer) 1005
   2) 110
6) 1) (integer) 985
   2) 100

Similarly, when the end timestamp for the range query is explicitly stated, you can set ALIGN to that time by setting align to + or to end.

See also

TS.RANGE | TS.MRANGE | TS.MREVRANGE

RedisTimeSeries


RATE THIS PAGE
Back to top ↑