Redis 核心数据类型与常用操作
🎯 引言
学完本文,你能按整份资料、对象字段、列表、去重成员和排名的需求,选择 Redis 数据类型并完成常用操作。
本篇使用 Node.js 22.9.0、redis 5.9.0、Redis 7.4.2。沿用入门篇的 redis.mjs,以下各组代码依次写入 types.mjs。先连接并清理本次实验的键:
import { redis } from './redis.mjs';
await redis.connect();
await redis.del([
'course:types:number', 'course:types:json',
'course:types:hash', 'course:types:list', 'course:types:set',
'course:types:other', 'course:types:rank',
]);
只删除这些练习键,避免旧数据影响输出。
🧱 String:字符串、数字与 JSON
String 是 Redis 的字符串类型,一个 Key 对应一份完整的值。读取时取得整份内容,写入同名 Key 时替换旧内容。数字和 JSON 也可以表示为字符串,但 Redis 不会因此把它们自动变成 JavaScript 数字或对象。
应用场景:适合保存一段文本、一个数值,或需要整体读取的查询结果。入门篇已演示普通文本,这里继续看数字和 JSON。
数字也可以用文本保存:
await redis.set('course:types:number', '10');
console.log(await redis.get('course:types:number'));
得到字符串 "10",不是 JavaScript 数字。计数时应使用后文的原子自增命令,避免自己读取再覆盖。
对象需要转成 JSON 文本后保存:
const user = { id: '42', name: 'Lin' };
await redis.set('course:types:json', JSON.stringify(user));
const raw = await redis.get('course:types:json');
console.log(raw === null ? null : JSON.parse(raw));
输出用户对象。这里假设内容由当前程序写入;业务缓存还要处理无效 JSON。普通 String 不提供 JSON 字段更新能力,修改姓名需要替换整份文本。
🛠 Hash:对象字段的存储与修改
Hash 是一个 Key 下的字段和值的集合。每个字段有自己的名称和值,可以单独读写;修改一个字段不会覆盖其他字段。
应用场景:适合保存结构较平坦、需要分别修改字段的资料,例如用户的姓名和城市。下面先写入字段,再单独读取城市:
await redis.hSet('course:types:hash', { name: 'Lin', city: 'Hangzhou' });
console.log(await redis.hGet('course:types:hash', 'city'));
输出 Hangzhou。hSet 写入字段,hGet 只读取指定字段。
只修改城市,再读取全部字段:
await redis.hSet('course:types:hash', 'city', 'Suzhou');
console.log(await redis.hGetAll('course:types:hash'));
结果包含 name: 'Lin' 和 city: 'Suzhou',姓名未被覆盖。字段值仍是字符串,嵌套对象不会自动转换为多层结构。
🧰 List:列表、队列与栈
List 是按加入位置保持顺序的字符串列表,允许出现重复元素。它支持从列表两端加入和取出元素,也可以按位置读取一段内容。取出会删除元素,读取则保留元素。
应用场景:适合保留一串有顺序的记录,或实现简单队列与栈。队列按先加入先取出的顺序处理,栈按后加入先取出的顺序处理。
下面从右侧加入、左侧取出,观察队列的顺序:
await redis.rPush('course:types:list', ['A', 'B', 'C']);
console.log(await redis.lPop('course:types:list'));
输出 A。接着从右侧加入、再从右侧取出,观察栈的顺序:
await redis.rPush('course:types:list', 'D');
console.log(await redis.rPop('course:types:list'));
console.log(await redis.lRange('course:types:list', 0, 1));
依次输出 D 和 ['B', 'C']。lRange 的结束位置包含在结果内,读取不会移除元素。
直接弹出元素没有处理确认机制;进程拿到内容后退出,可能丢掉未处理的任务。因此,简单 List 不适合直接承担需要失败重试的任务处理。
💡 Set:去重、成员判断与集合运算
Set 是不重复成员组成的集合,不保证返回顺序。重复添加同一成员不会新增一份,Redis 还可以判断成员是否存在,以及比较多个集合的共同项和差异。
应用场景:适合标签去重、关注关系的成员判断,以及寻找两组数据的共同成员。下面用标签验证去重和成员判断:
console.log(await redis.sAdd('course:types:set', ['js', 'vue', 'js']));
console.log(await redis.sIsMember('course:types:set', 'js'));
输出 2 和 1,分别表示新增两个成员、js 已存在;不存在时成员判断返回 0。
比较两组标签的共同项:
await redis.sAdd('course:types:other', ['js', 'css']);
console.log(await redis.sInter(['course:types:set', 'course:types:other']));
输出 ['js']。sUnion 求并集,sDiff 求第一组中不在后续组里的成员;数据量很大时,集合运算与返回结果也会占用资源。
✨ Sorted Set:排序、分数与排行榜
Sorted Set 是有序集合,每个不重复的成员都关联一个数字分数。Redis 按分数排列成员,支持读取指定排名范围或分数范围。成员不能重复,但不同成员可以拥有相同分数。
应用场景:适合积分排行榜,也适合用时间作为分数、按时间范围查询记录。下面用积分观察排序:
await redis.zAdd('course:types:rank', [
{ value: 'Lin', score: 80 },
{ value: 'Mei', score: 95 },
{ value: 'Kai', score: 70 },
]);
value 是成员,score 是参与排序的分数;重复写入同一成员会更新它的分数。读取积分前两名:
console.log(await redis.zRangeWithScores('course:types:rank', 0, 1, { REV: true }));
结果依次是 Mei 的 95 分和 Lin 的 80 分。0, 1 表示前两个位置,REV: true 表示从高分向低分排列;同分时按成员的字节字典序确定顺序,业务有其他并列规则时需另行设计。
⚖️ 五种数据类型的区别与选型
| 需求 | 类型 | 选择原因 |
|---|---|---|
| 整份接口 JSON | String | 整体读取和替换方便 |
| 单独修改对象字段 | Hash | 不必覆盖其他字段 |
| 保留顺序,允许重复 | List | 两端加入、取出 |
| 去重、成员判断、求共同项 | Set | 按成员管理集合 |
| 按积分取排名 | Sorted Set | 成员与分数一起保存 |
同一个 Key 同一时刻只有一种类型。对 Hash 调用普通 get 会报 WRONGTYPE,应按实际结构选择命令。可以查阅 Redis 数据类型了解各结构的用途。
最后关闭连接:
await redis.close();
运行完整脚本,按上面的顺序观察输出:
node types.mjs
❓ 知识问答
Q1:String 中保存 JSON,与 Hash 有什么区别?
JSON 是一整段文本;Hash 的字段可单独读写。按你的更新方式选择,不能只看 JavaScript 中是否为对象。
Q2:List 会自动去重吗?
不会。需要成员不重复时用 Set;需要同时排序时考虑 Sorted Set。
Q3:可以直接把整个大集合返回给接口吗?
应限制返回数量。大量元素的读取、传输和 JSON 转换都会消耗资源,优先按范围或分批读取。
🧪 小练习
给排行榜中的 Kai 更新积分为 100,再读取前两名;然后给 Hash 删除一个字段,观察剩余字段。
// 请在这里编写代码
// 提示:zAdd、zRangeWithScores、hDel、hGetAll
🎉 恭喜你已经掌握 Redis 常用数据类型的选择方法啦!
