首页/数据/数据库速查/OBJECT 子命令(编码/引用/空闲/频率)
Redis 命令96 条

OBJECT 子命令(编码/引用/空闲/频率)

OBJECT 查看键的内部信息:ENCODING 看底层结构、REFCOUNT 引用计数、IDLETIME 空闲秒数、FREQ 访问频率(LFU);排查内存与淘汰行为时非常有用。

数据库速查数据更新于 2026-10-12

常用查询

常用查询
SET n 123
OBJECT ENCODING n        # -> int
SET s hello
OBJECT ENCODING s        # -> embstr
RPUSH l a b c
OBJECT ENCODING l        # -> listpack
OBJECT REFCOUNT n        # -> 2147483647(0-9999 共享整数)
OBJECT IDLETIME n        # 空闲秒数(LFU 策略下不可用)
OBJECT FREQ n            # 仅 LFU 策略下有效
OBJECT HELP

常见编码

类型小数据大数据
stringint / embstrraw
listlistpackquicklist
hashlistpackhashtable
setintset / listpackhashtable
zsetlistpack(7.0+)skiplist
编码会随元素数量/大小自动转换(阈值:hash-max-listpack-entries 等),转换一般不可逆,除非重建键。

易错点

  • REFCOUNT=2147483647 不是 21 亿引用:那是共享整数的标记值
  • 按 ENCODING 写业务逻辑:编码随版本变化(如 zset 7.0 起小集合用 listpack)

数据来源与参考

  • Redis 官方文档: OBJECT ENCODING
  • Redis 官方文档: OBJECT IDLETIME

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌