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 脚本。
同分成员按字典序排列。若业务要求“先到先得”或其他并列规则,应明确设计额外的排序因子,并评估复合分数的精度、可解释性和更新成本。
按自己的节奏,确认真正理解。