Redis 与缓存 / 系统课时

添加与更新排序成员

添加与更新排序成员

本课解决 Sorted Set 成员如何新增、更新和按条件修改的问题。完成后,你可以使用 ZADD 写入分数,并用 NX、XX、GT、LT、CH 控制写入条件和返回值含义。

学习目标

  • 使用 ZADD 添加新成员或更新已有成员。
  • 使用 NX、XX、GT、LT 限制写入条件。
  • 正确解释默认返回值与 CH 返回值。

ZADD 的基本规则

ZADD key score member [score member ...] 可一次写入多个成员。新成员会被添加;已有成员会更新分数并自动调整位置。

默认返回值只统计新增成员数量,不统计已有成员的分数变化。添加 CH 后,返回值改为统计“新增或分数发生变化”的成员数量。

条件选项

NX 只添加不存在的成员,不更新已有成员;XX 只更新已有成员,不添加新成员,两者互斥。

GT 只在新分数更大时更新,LT 只在新分数更小时更新。GT 与 LT 互斥,二者也不能与 NX 组合;新成员不参与大小比较,除非同时使用 XX 阻止新增。

主示例:验证新增、条件更新与 CH

bash
redis-cli --raw DEL game:rank >/dev/null
redis-cli --raw ZADD game:rank 100 alice 90 bob
redis-cli --raw ZADD game:rank 120 alice 80 carol
redis-cli --raw ZADD game:rank NX 200 alice 70 dave
redis-cli --raw ZADD game:rank XX 130 alice 60 erin
redis-cli --raw ZADD game:rank GT CH 125 alice
redis-cli --raw ZADD game:rank GT CH 140 alice
redis-cli --raw ZRANGE game:rank 0 -1 WITHSCORES

预期输出

text
2
1
1
0
0
1
dave
70
carol
80
bob
90
alice
140

第二条 ZADD 更新 alice 并新增 carol,默认只返回新增数量 1。XX 将 alice 更新为 130,但仍返回 0,因为没有新增成员。随后 125 不满足 GT,140 满足 GT,配合 CH 分别返回 0 和 1。

使用边界

ZADD 的写入与排序调整在服务端原子完成,不需要先查询排名再决定位置。若业务只是基于旧分数做增减,应优先使用 ZINCRBY;更复杂的条件判断可使用 Lua 脚本。

同分成员按字典序排列。若业务要求“先到先得”或其他并列规则,应明确设计额外的排序因子,并评估复合分数的精度、可解释性和更新成本。

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

目录与阅读设置

阅读设置

17

记录一个想法

添加与更新排序成员

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

登录哪都通