Redis 与缓存 / 系统课时

查看键的数据类型

查看键的数据类型

本课学习使用 TYPE 确认键保存的逻辑数据结构。掌握后,你可以在调试未知键时选择正确命令,并快速定位因命令与类型不匹配产生的 WRONGTYPE 错误。

学习目标

  • 使用 TYPE 查看键的数据类型
  • 识别不存在键返回的 none
  • 根据类型选择正确的读取与修改命令

TYPE 的基本结果

TYPE key 返回键的逻辑类型。常见结果包括 string、list、set、zset、hash 和 stream;键不存在时返回 none。它不会读取值内容,也不会显示底层内部编码。

Redis 键类型与命令选择关系图

主示例:识别类型并修正命令

下面创建 String、List 和 Hash,然后查看类型、触发一次错误命令,再改用与 List 匹配的 LRANGE。

bash
redis-cli SET demo:string hello
redis-cli RPUSH demo:list a b c
redis-cli HSET demo:hash name Simon age 30
redis-cli TYPE demo:string
redis-cli TYPE demo:list
redis-cli TYPE demo:hash
redis-cli TYPE demo:missing
redis-cli GET demo:list
redis-cli LRANGE demo:list 0 -1

预期输出:

text
OK
(integer) 3
(integer) 2
string
list
hash
none
(error) WRONGTYPE Operation against a key holding the wrong kind of value
1) "a"
2) "b"
3) "c"

HSET 返回 2,表示新增了两个字段。none 表示键不存在,不是键中保存了字符串 "none"。

TYPE 与内部编码的区别

逻辑类型决定可使用的命令,内部编码决定 Redis 如何在内存中保存对象。同为 Hash,小对象和大对象可能采用不同编码,但 TYPE 都只返回 hash。

需要进一步分析内存时,可使用 OBJECT ENCODING key 查看内部编码。排查普通类型错误时,先用 TYPE 已经足够。

避免业务键发生类型漂移

同一个键不应在不同代码路径中保存不同类型。例如某处把 user:1001 写成 String,另一处又把它当 Hash 操作,会在运行时产生 WRONGTYPE。

更稳定的做法是让键名体现用途,例如 user:1001:profile 固定为 Hash,user:1001:tags 固定为 Set,并在代码中集中封装读写命令。

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

目录与阅读设置

阅读设置

17

记录一个想法

查看键的数据类型

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

登录哪都通