Redis 核心数据类型与常用操作

掌握 Redis 五种核心数据类型的常用操作,并根据数据需求选择合适的类型。

🎯 引言

学完本文,你能按整份资料、对象字段、列表、去重成员和排名的需求,选择 Redis 数据类型并完成常用操作。

本篇使用 Node.js 22.9.0、redis 5.9.0、Redis 7.4.2。沿用入门篇的 redis.mjs,以下各组代码依次写入 types.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。

数字也可以用文本保存:

types.mjs
await redis.set('course:types:number', '10');
console.log(await redis.get('course:types:number'));

得到字符串 "10",不是 JavaScript 数字。计数时应使用后文的原子自增命令,避免自己读取再覆盖。

对象需要转成 JSON 文本后保存:

types.mjs
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 下的字段和值的集合。每个字段有自己的名称和值,可以单独读写;修改一个字段不会覆盖其他字段。

应用场景:适合保存结构较平坦、需要分别修改字段的资料,例如用户的姓名和城市。下面先写入字段,再单独读取城市:

types.mjs
await redis.hSet('course:types:hash', { name: 'Lin', city: 'Hangzhou' });
console.log(await redis.hGet('course:types:hash', 'city'));

输出 Hangzhou。hSet 写入字段,hGet 只读取指定字段。

只修改城市,再读取全部字段:

types.mjs
await redis.hSet('course:types:hash', 'city', 'Suzhou');
console.log(await redis.hGetAll('course:types:hash'));

结果包含 name: 'Lin' 和 city: 'Suzhou',姓名未被覆盖。字段值仍是字符串,嵌套对象不会自动转换为多层结构。


🧰 List:列表、队列与栈

List 是按加入位置保持顺序的字符串列表,允许出现重复元素。它支持从列表两端加入和取出元素,也可以按位置读取一段内容。取出会删除元素,读取则保留元素。

应用场景:适合保留一串有顺序的记录,或实现简单队列与栈。队列按先加入先取出的顺序处理,栈按后加入先取出的顺序处理。

下面从右侧加入、左侧取出,观察队列的顺序:

types.mjs
await redis.rPush('course:types:list', ['A', 'B', 'C']);
console.log(await redis.lPop('course:types:list'));

输出 A。接着从右侧加入、再从右侧取出,观察栈的顺序:

types.mjs
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 还可以判断成员是否存在,以及比较多个集合的共同项和差异。

应用场景:适合标签去重、关注关系的成员判断,以及寻找两组数据的共同成员。下面用标签验证去重和成员判断:

types.mjs
console.log(await redis.sAdd('course:types:set', ['js', 'vue', 'js']));
console.log(await redis.sIsMember('course:types:set', 'js'));

输出 2 和 1,分别表示新增两个成员、js 已存在;不存在时成员判断返回 0。

比较两组标签的共同项:

types.mjs
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 按分数排列成员,支持读取指定排名范围或分数范围。成员不能重复,但不同成员可以拥有相同分数。

应用场景:适合积分排行榜,也适合用时间作为分数、按时间范围查询记录。下面用积分观察排序:

types.mjs
await redis.zAdd('course:types:rank', [
    { value: 'Lin', score: 80 },
    { value: 'Mei', score: 95 },
    { value: 'Kai', score: 70 },
]);

value 是成员,score 是参与排序的分数;重复写入同一成员会更新它的分数。读取积分前两名:

types.mjs
console.log(await redis.zRangeWithScores('course:types:rank', 0, 1, { REV: true }));

结果依次是 Mei 的 95 分和 Lin 的 80 分。0, 1 表示前两个位置,REV: true 表示从高分向低分排列;同分时按成员的字节字典序确定顺序,业务有其他并列规则时需另行设计。


⚖️ 五种数据类型的区别与选型

需求类型选择原因
整份接口 JSONString整体读取和替换方便
单独修改对象字段Hash不必覆盖其他字段
保留顺序,允许重复List两端加入、取出
去重、成员判断、求共同项Set按成员管理集合
按积分取排名Sorted Set成员与分数一起保存

同一个 Key 同一时刻只有一种类型。对 Hash 调用普通 get 会报 WRONGTYPE,应按实际结构选择命令。可以查阅 Redis 数据类型了解各结构的用途。

最后关闭连接:

types.mjs
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 常用数据类型的选择方法啦!