Redis 与缓存 / 系统课时

按分数范围查询

按分数范围查询

本课解决如何按分数条件筛选 Sorted Set 成员。完成后,你可以使用 ZRANGEBYSCORE 设置上下界、开闭区间和分页参数,并正确处理无穷边界与同分游标问题。

学习目标

  • 使用分数上下界筛选成员。
  • 使用圆括号表达开区间,并掌握无穷边界。
  • 使用 LIMIT 控制返回数量并识别分页边界。

分数边界规则

ZRANGEBYSCORE key min max [WITHSCORES] 按分数从小到大返回成员,默认包含最小值和最大值。添加 WITHSCORES 后,同时返回每个成员的分数。Redis 6.2 起也可使用统一语法 ZRANGE key min max BYSCORE WITHSCORES,新项目建议优先使用后者。

数字前加左圆括号表示排除该边界,例如 '(60' 表示严格大于 60,'(90' 表示严格小于 90。在 Shell 中应给含圆括号的参数加引号,避免被解释为特殊语法。

-inf 表示负无穷,+inf 表示正无穷,适合查询低于某值或高于某值的全部成员。结果默认按分数升序排列,同分时按成员字典序排列,因此查询结果具有确定的排序规则。

例如,60 90 表示包含 60 和 90,'(60' 90 表示大于 60 且小于等于 90,而 -inf '(60' 表示所有低于 60 的成员。上下界顺序不能颠倒,最小边界大于最大边界时返回空结果。

主示例:闭区间、开区间与 LIMIT

下面创建包含五名学生成绩的有序集合,连续执行四种查询。确保 Redis 服务已启动,并在可使用 redis-cli 的 Bash 环境运行。

bash
# 重建示例数据,避免已有成员影响查询结果
redis-cli --raw DEL exam:scores >/dev/null
redis-cli --raw ZADD exam:scores 59 tom 60 alice 75 bob 90 carol 100 dave
printf 'closed-60-90\n'
redis-cli --raw ZRANGEBYSCORE exam:scores 60 90 WITHSCORES
printf 'open-min-60\n'
redis-cli --raw ZRANGEBYSCORE exam:scores '(60' 90 WITHSCORES
printf 'below-60\n'
redis-cli --raw ZRANGEBYSCORE exam:scores -inf '(60' WITHSCORES
# 先筛选分数不低于 60 的成员,再跳过第一个并取两个
printf 'paged-from-60\n'
redis-cli --raw ZRANGEBYSCORE exam:scores 60 +inf WITHSCORES LIMIT 1 2

预期输出

text
5
closed-60-90
alice
60
bob
75
carol
90
open-min-60
bob
75
carol
90
below-60
tom
59
paged-from-60
bob
75
carol
90

第一行的 5 是 ZADD 新增的成员数量。使用 --raw 时,WITHSCORES 返回的成员和分数分别占一行,因此输出中的 alice、60 是同一条记录。

对照四组查询结果,可以验证边界是否生效:闭区间包含 60 分的 alice 和 90 分的 carol;开区间排除了 alice;低于 60 分的查询只返回 tom;分页查询则跳过 alice,返回 bob 和 carol。

如果使用 Redis 6.2 及以上版本,可将第一条范围查询替换为 ZRANGE exam:scores 60 90 BYSCORE WITHSCORES,返回内容相同。采用新语法时,BYSCORE 必须保留,否则数值参数会按排名索引解释,而不是按分数解释。

LIMIT 与游标边界

LIMIT offset count 在符合分数范围的有序结果中跳过 offset 个成员,再返回最多 count 个成员。例如上面的 LIMIT 1 2 先跳过 alice,再读取 bob 和 carol。offset 从 0 开始,count 是数量而非结束位置。

这种方式适合结果集较小、只翻几页的查询,但较大的 offset 会增加跳过成员的成本,因此持续翻页不宜无限增大 offset。如果查询期间成员被插入、删除或修改分数,依靠固定偏移量翻页还可能出现重复或遗漏。

另一种方式是记录上一页最后一个分数,在下一页使用开区间继续查询。例如上一页结束于 75 分,下一页以 '(75' 为最小边界,即可跳过已经读取的分数。

但这种做法只有在分数唯一时才安全。假设 bob 和 eric 都是 75 分,第一页只读取到 bob,下一页直接从大于 75 分开始,就会漏掉 eric。同分成员虽然按字典序排列,但 ZRANGEBYSCORE 不能直接使用成员名称作为第二个排序游标。

需要跨页读取全部成员时,可以根据业务选择以下方法:

  • 分数保证唯一:使用上一页最后分数作为开区间边界,避免反复从头跳过成员。
  • 分数允许重复:保存同分组内的处理进度,继续读取未完成的同分成员,再进入更高分数区间。
  • 要求分页结果一致:在业务快照上分页,或在应用层使用稳定的复合游标,并明确处理查询期间的数据变动。

查询成绩区间、筛选积分或读取某个时间段的记录时,优先明确区间是否包含边界;需要分页时,再根据分数是否唯一以及数据是否会变化选择偏移量或游标方案。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

按分数范围查询

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

登录哪都通