Redis 与缓存 / 系统课时
查询成员分数与排名
查询成员分数与排名
本课解决如何查询某个 Sorted Set 成员的分数和名次。完成后,你可以用 ZSCORE 获取分数,用 ZRANK 与 ZREVRANK 获取升序、降序排名,并正确处理成员不存在和同分排名问题。
学习目标
- 使用
ZSCORE查询成员当前分数。 - 使用
ZRANK与ZREVRANK查询零基排名。 - 将 Redis 排名转换为面向用户的名次。
三个查询命令
ZSCORE key member 返回成员当前分数。成员或键不存在时返回空值,客户端必须区分空值与合法分数 0。例如成员实际分数为 0 时,返回的是表示零的分数字符串,而不是不存在。
ZRANK key member 按分数从小到大返回零基排名,最低分排名为 0;ZREVRANK key member 按分数从大到小返回零基排名,最高分排名为 0。两种排名都从 0 开始计数,成员不存在时均返回空值。
实际选择取决于业务规则:成绩越高越靠前的游戏排行榜通常使用 ZREVRANK;耗时越短越好的竞速榜则可以使用 ZRANK。两种命令都返回成员在当前排序中的位置,而不是分数本身。
主示例:查询分数与双向排名
在本地 Redis 已启动且 redis-cli 可以连接的环境中,先创建包含四名玩家的排行榜,再查询 dave 的分数与排名,同时检查不存在的成员。
redis-cli --raw DEL game:rank >/dev/null
redis-cli --raw ZADD game:rank 80 carol 90 bob 140 alice 110 dave
redis-cli --raw ZSCORE game:rank dave
# 空值在 --raw 模式下表现为空行,显式标记以便验证
missing=$(redis-cli --raw ZSCORE game:rank erin)
printf '%s\n' "${missing:-<EMPTY_RESULT>}"
redis-cli --raw ZRANK game:rank dave
redis-cli --raw ZREVRANK game:rank dave预期输出
4
110
<EMPTY_RESULT>
2
1第一行的 4 是 ZADD 新增的成员数量,不是排名。ZSCORE 返回 dave 的分数 110,不存在的 erin 返回空值,经 Shell 转换后显示为 <EMPTY_RESULT>。
按升序排列时,成员依次为 carol(80)、bob(90)、dave(110)、alice(140),所以 dave 的 ZRANK 为 2。按降序排列时,dave 排在 alice 之后,ZREVRANK 为 1。
常见高分榜按降序展示,因此面向用户可显示为第 1 + 1 = 2 名。转换公式为 显示名次 = Redis 零基排名 + 1,但只有在返回值非空时才能加 1。排名为 0 是合法的第一名,不能被误判为不存在。
同分与一致性
相同分数的成员仍会获得不同的内部排名,顺序由成员字典序决定:ZRANK 在同分时按成员字典序升序排列,ZREVRANK 则按逆序排列。
例如 bob 与 dave 都获得 110 分,Redis 仍会给两人分配不同的位置。如果业务要求同分同名次,应按分数分组,在应用层计算具体规则。对于降序成绩 140、110、110、80:
- 竞赛排名:
1、2、2、4,下一名跳过被并列占用的位置。 - 密集排名:
1、2、2、3,下一名不跳号。
直接使用 ZREVRANK + 1 得到的是位置名次,并不自动实现上述并列名次规则。排行榜接口应明确采用哪一种排名方式。
分数和排名分开查询时,集合可能在两条命令之间发生变化。例如查询分数后,其他客户端更新了该成员的成绩,随后查询的排名可能已经对应新分数。
需要严格一致的组合结果时,可以使用 Lua 脚本在一次原子执行中调用 ZSCORE 和 ZREVRANK,避免两次读取之间被其他客户端的写入打断。普通实时排行榜通常可以接受短暂变化,无须为每次查询引入脚本。
对于常规高分榜,使用 ZSCORE 展示分数、ZREVRANK 获取位置,并在确认成员存在后将零基排名加 1,即可完成成员成绩和名次的查询。