新闻详情

新闻详情

首页 / 资讯中心 / 详情

Redis命令:HGETALL

发布时间:2026/11/19 2:16:13来源:尧图网络
Redis命令:HGETALL
Redis HGETALL 命令详细教程HGETALL返回 Hash 中全部字段与值。回复长度是 Hash 大小的两倍字段顺序不保证稳定。资料合集https://pan.quark.cn/s/10e98d308913、https://pan.quark.cn/s/f56bc69c5338一、概览与语法HGETALL key项目说明数据类型Hash支持版本Redis 2.0.0 起key一个 Hash Key返回值RESP2 为字段与值交替出现的数组RESP3 为映射空结果Key 不存在时返回空数组RESP3 为空映射不是 Null时间复杂度O(N)N 为 Hash 大小ACLread、hash、slow命令标记readonly官方明确标注该命令的输出顺序不确定nondeterministic output order且被归类为slow因为耗时随 Hash 大小线性增长。$TRAE_REF二、基础示例以下命令在测试实例的 redis-cli 中执行。文中结果是预期说明未实际连接 Redis 运行。DEL tutorial:{hgetall}:user tutorial:{hgetall}:missing HSET tutorial:{hgetall}:user name Alice city Shanghai age 30 HGETALL tutorial:{hgetall}:user HLEN tutorial:{hgetall}:user HGETALL tutorial:{hgetall}:missing EXISTS tutorial:{hgetall}:missing预期结果HGETALL 返回 6 个元素的数组形如name Alice city Shanghai age 30但实际排列顺序可能不同HLEN 返回3对缺失 Key 调用返回空数组且不创建 KeyEXISTS 为0。注意返回的是“字段名、值”交替的扁平数组不是嵌套结构。字段数量等于回复长度的一半可用这一点做校验。三、输出顺序与解析Redis 不承诺 HGETALL 的字段顺序小型 Hash 常表现为插入顺序或内部编码顺序但这是实现细节不能作为业务依据。需要固定顺序时应在客户端对结果排序或改用 SORT 等显式排序手段。RESP2 与 RESP3 的形态差异会影响客户端解码协议形态典型客户端表现RESP2字段与值交替的数组列表、字符串数组、部分客户端已转换为字典RESP3映射Map直接是字典、Map 或对象redis-py 在 RESP2 下也会把 HGETALL 解码为字典但这属于客户端行为不代表服务端返回了映射结构。自行解析原始协议时应按“偶数下标为字段、奇数下标为值”处理并校验长度为偶数。pairs[name,Alice,age,30]result{pairs[i]:pairs[i1]foriinrange(0,len(pairs),2)}print(result)# {name: Alice, age: 30}四、空 Hash、缺失 Key 与错误类型场景行为Key 不存在返回空数组或空映射不报错不创建 KeyKey 已到期视作不存在返回空结果Hash 存在但字段全部到期或被删除由于最后一个字段消失时 Key 被删除通常表现为 Key 不存在Key 是 String、List 等非 Hash报 WRONGTYPE 错误字段值为空字符串正常返回该字段值为空字符串字段名重复不可能出现Hash 字段名唯一DEL tutorial:{hgetall}:empty HSET tutorial:{hgetall}:empty a HGETALL tutorial:{hgetall}:empty SET tutorial:{hgetall}:wrong text HGETALL tutorial:{hgetall}:wrong第二次调用返回a与空字符串两项说明值为空字符串的字段同样会被列出。最后一条命令报 WRONGTYPE。五、大 Hash 的性能风险HGETALL 的时间复杂度是 O(N)并且会把整个 Hash 一次性传输到客户端。字段很多或值很大时会造成明显的服务端阻塞风险、网络带宽占用和客户端内存压力。官方将其标记为slow正是基于这一点。场景建议方式只需要几个已知字段HMGET或用多条 HGET只关心字段名或值HKEYS、HVALS需要遍历大 HashHSCAN 增量游标遍历需要统计字段数量HLEN需要单个字段长度HSTRLEN确实需要全部数据HGETALL但先评估规模并考虑分批在线上排查“某个 Hash 到底有多大”时优先使用 HLEN而不是直接 HGETALL。必要时可在从库或离线实例上执行完整读取。六、客户端示例前提为已安装 redis-py 并准备好本地测试实例。importredis rredis.Redis(hostlocalhost,port6379,decode_responsesTrue)ktutorial:{hgetall}:pythontry:r.delete(k)r.hset(k,mapping{name:Alice,age:30,empty:})datar.hgetall(k)print(data)# {name: Alice, age: 30, empty: }print(len(data))# 3print(data.get(absent))# Noneprint(r.hgetall(tutorial:{hgetall}:missing))# {}finally:r.delete(k)r.close()JavaJedis示例返回 Maptry(JedisjedisnewJedis(localhost,6379)){jedis.hset(tutorial:{hgetall}:java,name,Alice);jedis.hset(tutorial:{hgetall}:java,age,30);MapString,Stringalljedis.hgetAll(tutorial:{hgetall}:java);System.out.println(all);jedis.del(tutorial:{hgetall}:java);}七、原子性、一致性与常见用途单条 HGETALL 是原子的返回的是执行瞬间的一致快照不会读到“写了一半”的 Hash。但如果先 HGETALL 再写回两次调用之间其他客户端可能已经修改数据这种“读改写”流程不具备原子性应按需求使用 WATCH 事务或 Lua 脚本。典型用途读取小对象的所有属性、把 Hash 当作对象存储后整体加载、配置项一次性取出、缓存预热。不要把它当作全量扫描工具用于大 Key也不要在高频接口中对大 Hash 反复调用。八、练习、排错与总结练习新建tutorial:{hgetall}:exercise写入 a1、b2、c3执行 HGETALL 并确认返回 6 个元素用 HLEN 确认字段数为 3执行HDEL ... a b c后再次 HGETALL预期得到空数组且 EXISTS 为 0说明最后一个字段被删除时整个 Key 一并消失。排错要点返回空结果时先用 EXISTS 区分 Key 缺失与 Hash 为空报 WRONGTYPE 时用 TYPE 检查类型结果顺序与预期不同属正常现象不应依赖顺序客户端拿到的字段数少于预期时检查是否有字段已到期出现明显延迟时评估 Hash 规模并改用 HSCAN。清理使用DEL tutorial:{hgetall}:user tutorial:{hgetall}:missing tutorial:{hgetall}:empty tutorial:{hgetall}:wrong tutorial:{hgetall}:exercise。速记读取全部字段与值、O(N) 且标记为慢命令、顺序不保证、缺失 Key 返回空结果而非 Null、大 Hash 优先用 HSCAN。
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

【外设】之大彩串口显示屏 2026/11/18 21:21:17

【外设】之大彩串口显示屏

大彩串口屏初步使用 1 .官网下载 STM32 屏幕 GUI 设计资料 http://www.gz-dc.com/category/typeid/4112 找到 STM32 Keil 工程,移植相关代码因项目而异进行移植,由于项目简单,本人只对用到的指令接口进行修改。 比如:注意事项&…

阅读更多 →
无法下载Windows系统iso文件 2026/11/18 14:20:46

无法下载Windows系统iso文件

当我遇到这个问题的时候,我打开了一个网站: 登录 然后我打算下载的时候: 突然那个官方的连接就可以下载了:

阅读更多 →
【清华代码熊】DeepSeek V4.1 Flash 后训练详解 2026/11/18 20:01:42

【清华代码熊】DeepSeek V4.1 Flash 后训练详解

📌 上期解析了 DeepSeek V4.1 Flash 模型架构改进,本期解析 DeepSeek V4.1 Flash 预训练/后训练技术: 🌟 预训练:45T 文本 多模态混合语料、直接训练 sparse attention(取消 DeepSeek V4 的 dense 冷启动&…

阅读更多 →
Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ... 2026/11/18 11:04:06

Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ...

文章主要内容和创新点 主要内容 本文聚焦于多模态大语言模型(MLLM)强化学习(RL)训练中的效率问题,提出了一个名为Shuffle-R1的框架。研究发现,当前RL训练存在两个关键缺陷: 优势值坍缩(Advantage Collapsing):批次中大多数优势值集中在零附近,导致有效梯度信号被淹…

阅读更多 →
PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction 2026/11/18 15:55:22

PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction

一、文章主要内容总结 本文聚焦于利用大型语言模型(LLMs)实现个人身份信息(PII)脱敏的研究,旨在解决传统脱敏方法(如基于规则的系统、领域特定命名实体识别(NER)模型)泛化能力差、跨格式/跨语境适应性弱的问题。 研究通过全面评估多种LLM架构(包括密集型LLM(D-LLM…

阅读更多 →
LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model 2026/11/18 21:21:16

LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model

文章主要内容和创新点 主要内容 本文聚焦于二进制图像-文本相关性评估任务(判断图像与文本“相关”或“不相关”),针对该任务中文本格式多样、相关性定义随场景变化等挑战,提出了基于多模态大语言模型(MLLM)的解决方案LLaVA-RE。 模型设计:LLaVA-RE基于LLaVA 1.5架构,…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉