首页/数据/Redis 进阶速查/HSCAN/SSCAN/ZSCAN 遍历容器元素
本包目录(421 条)
数据结构与选型42 条持久化56 条主从与哨兵51 条Cluster 集群44 条内存与管理99 条
性能与排障129 条

HSCAN/SSCAN/ZSCAN 遍历容器元素

对 Hash/Set/ZSet 使用对应 SCAN 家族命令渐进遍历大容器,避免 HGETALL/SMEMBERS 一次性返回海量元素造成阻塞。

Redis 进阶速查数据更新于 2026-10-12
命令HSCAN key cursor / SSCAN / ZSCAN
返回下一游标加元素(ZSCAN 为成员与分数成对)
选项MATCH pattern、COUNT n

示例

示例
redis-cli HSCAN user:big 0 MATCH name* COUNT 100
redis-cli ZSCAN rank:big 0 COUNT 100
redis-cli SSCAN tags:big 0 COUNT 100
ZSCAN 结果里成员与分数交替出现,客户端解析时按两个一组处理。

易错点

  • SCAN 家族单次调用工作量仍与编码和 COUNT 相关,超时敏感业务应限制单次规模
  • 部分较新参数(如 HSCAN 的 NOVALUES)在旧版本上会报语法错误,使用前核对版本

数据来源与参考

  • Redis 官方文档:HSCAN / SSCAN / ZSCAN 命令
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌