XDEL
语法
XDEL key id [id ...]
- 自版本
- 5.0.0
- 时间复杂度
- 对于流中的每个要删除的单个项目,时间复杂度为 O(1),与流的大小无关。
- ACL 类别
-
@write
,@stream
,@fast
,
从流中删除指定的条目,并返回删除的条目数量。如果某些指定的 ID 不存在于流中,则此数字可能小于传递给命令的 ID 数量。
通常你可能将 Redis 流视为一种追加式数据结构,但是 Redis 流是在内存中表示的,因此我们也能够删除条目。例如,这可能在符合某些隐私策略时很有用。
了解条目删除的底层细节
Redis 流以一种使它们内存高效的方式表示:使用基数树来索引宏节点,这些宏节点线性地打包数十个流条目。通常,当你从流中删除条目时,条目并没有真正被删除,它只是被标记为已删除。
最终,如果宏节点中的所有条目都被标记为已删除,则整个节点将被销毁并回收内存。这意味着,如果你从流中删除大量条目,例如超过追加到流的条目的 50%,则每个条目的内存使用量可能会增加,因为流会变得碎片化。但是流性能将保持不变。
在 Redis 的未来版本中,如果某个宏节点达到一定数量的已删除条目,我们可能会触发节点垃圾回收。目前,根据我们对这种数据结构的预期使用情况,添加这种复杂性并不是一个好主意。
示例
> XADD mystream * a 1
1538561698944-0
> XADD mystream * b 2
1538561700640-0
> XADD mystream * c 3
1538561701744-0
> XDEL mystream 1538561700640-0
(integer) 1
127.0.0.1:6379> XRANGE mystream - +
1) 1) 1538561698944-0
2) 1) "a"
2) "1"
2) 1) 1538561701744-0
2) 1) "c"
2) "3"