Agent Skills
返回列表
💻

Redis 核心数据建模

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/redis-agent-skills-redis-core。

技能介绍

你在 Redis 里常踩的坑

很多服务在 Redis 里用「一个 key 存一整段 JSON 字符串」,改一个字段就要整包读出、反序列化、再写回——既费内存也容易在并发下覆盖别人刚写的字段。另一类问题是键名随人随模块乱长:User_1001_Profile、tenant42user7cart 混在一起,扫描、多租户隔离和排障都变痛苦。选型也常常只看数据「长什么样」,不看访问模式(只读整对象 vs 频繁改单字段、要不要排序、要不要唯一成员)。

技能在帮你做哪两件事

这份指南把建模决策收成两条主线:数据结构选型与键名约定。

  • 按访问模式选类型:简单计数用 String(INCR/DECR);可独立更新字段的实体用 Hash,避免整对象重写;队列与「最近 N 条」用 List;去重与成员判断用 Set;排行榜与分数区间用 Sorted Set;嵌套层级、路径级更新考虑 JSON;事件日志与消费组用 Stream;向量检索场景用 Vector Set。
  • 键名分层:小写、冒号分段(如 tenant:42:user:7:cart),短而可读;不把完整 URL 当 key,用短 id 或摘要;多租户统一前缀,便于 SCAN 与 ACL 收敛。

文档里点名的反模式很具体:把扁平对象塞进序列化字符串——应改用 Hash,并配合 references/choose-data-structure.md、references/key-naming.md 里的理由与示例做对照。

适用边界

它讲的是建模与命名惯例,不是部署、主从切换、内存淘汰策略或 Lua 脚本调优。也不替代你对业务 SLA 的容量评估;Stream、Vector Set 等能力需以你实际 Redis 版本与模块为准。适合在方案评审、存量 key 重构、以及 Hash 与 JSON 文档二选一 时作为检查清单使用。

使用场景

  • 会话或用户状态上 Redis 时,要在 String、Hash、JSON 之间按字段更新频率拍板
  • 实现排行榜、计数器或「最近浏览」列表,需要对照访问模式选 Sorted Set、String 或 List
  • 线上 key 命名混乱,准备做一次命名空间梳理并统一多租户前缀
  • 实体缓存从「整段 JSON 字符串」迁到 Hash 或 RedisJSON,评估改写成本与读写路径

适合人员

  • 负责用户中心或订单缓存的后端,要在不改业务语义前提下降低 Redis 内存与写放大
  • 维护实时榜单、限流计数的服务 owner,需要把选型依据写进设计评审材料
  • 多租户 SaaS 里管数据层的工程师,要通过统一 key 前缀简化 SCAN 与权限隔离
  • 做存量 Redis 治理的技术 lead,正在盘点反模式 key 并制定团队命名规范