首页/数据/数据库速查/SSCAN 游标遍历集合
Redis 命令96 条

SSCAN 游标遍历集合

渐进遍历集合成员:SSCAN key cursor [MATCH pattern] [COUNT n],游标归零表示结束;大集合的唯一安全遍历方式。

数据库速查数据更新于 2026-10-12

示例

示例
SADD big:set a1 a2 a3 ... a100000
SSCAN big:set 0 COUNT 500
# 1) "512"  2) 1) a1 2) a7 ...
SSCAN big:set 512 COUNT 500    # 用返回游标继续
SSCAN big:set 0 MATCH user:* COUNT 500   # 模式过滤
cursor0 开始,返回 0 结束
COUNT扫描提示量,不保证精确
MATCH成员模式过滤,仍全量扫描后筛选
MATCH 不会减少扫描工作量(只是过滤输出);集合大到无法全扫时,应预先按前缀分桶建多个小集合。

易错点

  • 用 SMEMBERS 遍历大集合:阻塞甚至打爆客户端内存
  • 遍历期间集合增删导致重复返回:业务侧幂等处理

数据来源与参考

  • Redis 官方文档: SSCAN
  • Redis 官方文档: SCAN

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌