Redis 与缓存 / 知识点

Redis 开发常用命令速查

去重与集合运算

CODE
SSCAN key cursor [MATCH pattern] [COUNT count]

用游标渐进获取大集合成员,适合离线处理和核对样本;COUNT 不保证每次返回固定数量,重复成员应在调用方做好幂等处理。

分批扫描集合成员

当 Redis Set 包含大量成员,需要分批核对、导出或执行离线处理时,使用 `SSCAN` 通过游标渐进读取,避免像 `SMEMBERS` 一样一次性返回整个集合。一次完整遍历从游标 `0` 开始,以服务端最终返回游标 `0` 结束。

基本语法

text
SSCAN key cursor [MATCH pattern] [COUNT count]
参数 含义 约束或默认值
`key` 待扫描的 Set 键 必须是 Set 类型;不存在的键返回空集合
`cursor` 本轮扫描起点 首次传 `0`,后续传上次返回的游标
`MATCH pattern` 按 glob 模式筛选成员 可选;如 `tag:*`,不是正则表达式
`COUNT count` 建议本次扫描的工作量 可选,默认 `10`;不保证固定返回数量

`SSCAN` 返回两个部分:下一次使用的游标,以及本批成员数组。游标不为 `0` 时,即使本批成员为空,也必须继续扫描。

该命令从 Redis 2.8.0 开始支持。单次调用通常为 O(1),完整遍历为 O(N),其中 N 是集合成员数量。`COUNT` 是工作量提示,不是严格分页上限;紧凑编码的小集合可能一次返回全部成员。

可验证示例

前置条件:本机 Redis 服务已启动,已安装 `redis-cli`,并在隔离测试库中确认 `demo:sscan:guide` 尚不存在。下面先创建包含三个成员的集合,再筛选以 `tag:` 开头的成员。

bash
# 仅在隔离测试库创建演示集合
redis-cli SADD demo:sscan:guide tag:alpha tag:beta misc
# MATCH 只过滤返回成员,COUNT 100 不是强制返回 100 个
redis-cli SSCAN demo:sscan:guide 0 MATCH 'tag:*' COUNT 100

预期输出(小集合的一种可能结果):

text
(integer) 3
1) "0"
2) 1) "tag:alpha"
   2) "tag:beta"

第一条命令在键不存在时新增三个成员,因此返回 `3`。第二条返回两个匹配成员,不包含 `misc`。成员顺序不保证固定,实际游标和批次数也可能不同。

如果返回游标不是 `0`,应将其作为下一条 `SSCAN` 的 `cursor`,并保持原来的键名与筛选条件,直到返回游标为 `0`。不要把返回成员数量不足 `COUNT` 当作遍历完成。

游标与结果处理

实际批处理建议遵循以下顺序:

  1. 将游标初始化为 `0`,执行首次 `SSCAN`。
  2. 读取返回的成员并执行业务处理,同时保存返回游标。
  3. 对成员执行幂等操作,或使用持久化去重记录避免重复处理。
  4. 如果返回游标不为 `0`,继续使用该游标发起下一次调用。
  5. 只有返回游标为 `0`,才标记本轮遍历结束。

`MATCH` 是在扫描候选成员后应用的过滤条件,因此匹配较少时可能连续出现空批次。`SSCAN` 也不是基于固定偏移量的分页接口,不能使用页码代替游标,或自行对游标加一。

需要断点续扫时,可以在完成当前批次的处理后保存游标和处理进度。恢复后从保存的游标继续,但集合发生修改时不能保证恢复结果与原先完全一致;处理操作仍需支持重试和去重。

风险与恢复

  • **重复成员**:同一成员在完整遍历中可能被返回多次。涉及计费、通知或数据迁移时,应使用成员 ID 实现幂等,不能简单地对每次返回结果累加。
  • **并发修改**:遍历期间新增或删除的成员可能出现或被遗漏。始终存在于整个遍历期间的成员会被返回,但扫描不能替代一致性快照。需要精确核对时,应先获得稳定的数据副本。
  • **类型错误**:对 String、List 等非 Set 键执行 `SSCAN` 会返回 `WRONGTYPE` 错误。先使用 `TYPE demo:tags` 核对类型,确认是 `set` 后再扫描。
  • **性能波动**:增大 `COUNT` 通常能减少往返次数,但也可能增加单次响应大小和处理延迟。生产环境建议从 `COUNT 100` 等保守值开始,根据响应时间和吞吐调整。
  • **误中断**:扫描无须显式关闭,也不会遗留服务端游标状态。若游标丢失,可以从 `0` 重新扫描,但必须重新执行去重或幂等检查。

演示结束后,仅在确认测试键确实由本次操作创建、没有其他用途时执行清理:

bash
# 删除本次创建的临时演示集合
redis-cli DEL demo:sscan:guide

预期输出:键仍存在时返回 `(integer) 1`,已不存在时返回 `(integer) 0`。`DEL` 不可直接撤销;误删业务键只能依赖已有备份或业务数据重建。

速查:`SSCAN` 的结束条件永远是**返回游标等于 `0`**,不是成员列表为空,也不是本批数量小于 `COUNT`。

排序与排行榜

JSON 文档更新

实时事件广播

可确认的流式队列

目录与阅读设置

记录一个想法

Redis 开发常用命令速查

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通