Redis 8.10 HIMPORT 为什么更适合批量写 Hash：fieldset 复用与连接边界

批量导入用户画像时，几万个 Hash 都是 name、email、age 三个字段。逐条发送 HSET 虽然直观，却会反复传输同一组字段名。Redis Open Source 8.10 提供的 HIMPORT，适合把这类固定 schema 先声明为 fieldset，再按顺序只提交每个键的 values。

HSET 重复字段名，HIMPORT 复用 fieldset

普通 HSET 每次都要带上字段名和值。HIMPORT 把这两部分拆开：先由客户端连接发送 HIMPORT PREPARE，创建名为 fieldset u 的字段集合 name/email/age；后续 HIMPORT SET 只发送键名和对应的 values。

HIMPORT PREPARE u name email age
HIMPORT SET user:1 u Alice alice@example.com 30
HIMPORT SET user:2 u Bob bob@example.com 25

这样生成的 user:1 Hash 和 user:2 Hash 仍可用既有 Hash 命令读取。官方文档还说明，共享字段名会成为紧凑 Hash 编码的提示；对大量相同结构的键，收益不只是少传几次字段名。

连接级 fieldset 是关键边界

fieldset u 只属于创建它的 Client A。它不是数据库键，也不会让 Client B 自动获得同名模板；其他连接处于“无法引用 fieldset u”的状态。连接池场景尤其要注意：PREPARE 与随后的 SET 必须落在同一条连接上。

清理方式有三种：HIMPORT DISCARD 删除一个 fieldset，HIMPORT DISCARDALL 删除当前连接保存的全部 fieldset，RESET 或连接关闭也会清空它们。这里不要把 fieldset 当成可持久化配置。

什么时候值得换成 HIMPORT

落地前再核对两件事：values 的顺序必须与 PREPARE 中的字段顺序一致；客户端库是否已经支持 HIMPORT。若只能透传原生命令，也要把 PREPARE、连续 SET 和清理放在同一连接生命周期内。

相关问题

HIMPORT 创建的 Hash 还能用 HGETALL 吗？

可以。紧凑编码不会改变既有 Hash 命令的行为和返回语义。

fieldset 会在 Redis 重启后保留吗？

不会。它属于客户端连接会话，连接关闭、RESET 或显式清理都会让它失效。

判断是否采用 HIMPORT，不要只看“批量”两个字。真正的门槛是大量键共享同一套有序字段，并且应用能稳定控制同一条连接；满足这两点，它才比反复 HSET 更合适。