Redis 与缓存 / 系统课时

查看字段数量

查看字段数量

本课使用 HLEN、HKEYS 和 HVALS 查看 Hash 的结构信息。你将能按需求选择计数或全量读取命令,并识别大型 Hash 上一次返回全部字段带来的阻塞与网络风险。

学习目标

  • 使用 HLEN 获取字段数量
  • 使用 HKEYS 和 HVALS 查看字段名或字段值
  • 避免在大型 Hash 上执行高开销全量命令

查看结构信息

HLEN key 返回字段数量;HKEYS key 返回全部字段名;HVALS key 返回全部字段值。下面使用一个小型配置 Hash 演示三条命令。

bash
redis-cli DEL app:config >/dev/null
redis-cli HSET app:config theme dark language zh-CN pageSize 20
redis-cli HLEN app:config
redis-cli HKEYS app:config
redis-cli HVALS app:config

预期输出

text
(integer) 3
(integer) 3
1) "theme"
2) "language"
3) "pageSize"
1) "dark"
2) "zh-CN"
3) "20"

示例中的字段顺序仅用于说明,实际顺序由 Hash 当前遍历结果决定,业务代码不应依赖固定排列。HKEYS 与 HVALS 是两次独立读取,也不适合按相同下标强行配对;需要字段和值一起返回时,应使用 HGETALL 或按已知字段名读取。

按需求选择命令

只想知道字段数量时使用 HLEN,不要为了计数先取回全部字段。只需要字段名时使用 HKEYS;只需要所有值且不关心字段名时使用 HVALS。

键不存在时,HLEN 返回 0,HKEYS 和 HVALS 返回空列表。这与“没有可返回字段”的结果一致。Redis 不会长期保留空 Hash,因为最后一个字段被删除后键会自动消失。

大型 Hash 的风险

HKEYS、HVALS 和 HGETALL 都会遍历并一次返回全部内容,时间复杂度与字段数量相关。字段很多时,它们会占用 Redis 主线程执行时间,并产生较大的网络响应和客户端内存开销。

管理后台偶尔查看小型配置时可以使用全量命令;在线请求链路中应先评估字段规模。需要分批处理大型 Hash 时,应改用 HSCAN,同时接受游标扫描的弱一致性和批次大小不固定等特征。

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

目录与阅读设置

阅读设置

17

记录一个想法

查看字段数量

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

登录哪都通