TS.DEL

删除给定时间序列的两个时间戳之间的所有样本

语法

TS.DEL key from timestamp to timestamp

引入版本：1.6.0

复杂度摘要：O(N)

删除给定时间序列的两个时间戳之间的所有样本

示例

必需参数

key

是时间序列的键名称。

fromTimestamp

是范围删除的开始时间戳。

toTimestamp

是范围删除的结束时间戳。

给定的时间戳间隔是封闭的（含），即时间戳等于 fromTimestamp 或 toTimestamp 的样本也会被删除。

Notes:

  • 如果与最大现有时间戳相比，fromTimestamp 早于保留期，则删除操作将被丢弃并返回错误。
  • 从定义了压缩规则的时间序列中删除样本时：
  • 如果受影响的压缩桶的所有原始样本都可用，则根据剩余的原始样本重新计算压缩值，或者如果删除了压缩桶内的所有原始样本，则删除压缩值。
  • 如果受影响的压缩桶的原始样本已过期，则删除操作将被丢弃并返回错误。
  • 从压缩时间序列中显式删除样本可能会导致原始数据和压缩数据之间不一致。压缩过程可能会覆盖此类样本。话虽如此，在原始时间序列的保留期限之外，从压缩时间序列中显式删除样本是安全的。

示例

Delete range of data points

创建特拉维夫和耶路撒冷温度的时间序列，然后添加不同的温度样本。

127.0.0.1:6379> TS.CREATE temp:TLV LABELS 类型临时位置 TLV OK 127.0.0.1:6379> TS.CREATE temp:JLM LABELS 类型临时位置 JLM OK 127.0.0.1:6379> TS.MADD temp:TLV 1000 30 temp:TLV 1010 35 温度：TLV 1020 9999 温度：TLV 1030 40 1)（整数）1000 2）（整数）1010 3）（整数）1020 4)（整数）1030 127.0.0.1:6379> TS.MADD 温度：JLM 1005 30 温度：JLM 1015 35 温度：JLM 1025 9999 温度：JLM 1035 40 1)（整数）1005 2）（整数）1015 3）（整数）1025 4）（整数）1035

删除特拉维夫温度数据点范围。

127.0.0.1:6379> TS.DEL 温度:TLV 1000 1030（整数）4

Redis Software 与 Redis Cloud 兼容性

Redis
软件		 Redis
Cloud		 说明
✅ 支持
 ✅ 灵活且每年一次
✅ 免费和固定

返回值

RESP2

以下之一： * 整数回复：已删除的样本数。 * 简单错误回复 在这些情况下：无效参数、错误的键类型、与最大现有时间戳相比，timestamp 早于保留期，或者无法重新计算受影响的压缩存储桶时。

RESP3

以下之一： * 整数回复：已删除的样本数。 * 简单错误回复 在这些情况下：无效参数、错误的键类型、与最大现有时间戳相比，timestamp 早于保留期，或者无法重新计算受影响的压缩存储桶时。

参见

TS.ADD

Redis时间系列

资料来源：Redis 官方 TS.DEL 文档；中文内容参考 Redis 文档许可。