HIMPORT SET

按已定义字段集的顺序写入哈希值。

语法

HIMPORT SET key fieldset-name value [value ...]

引入版本：8.10.0

复杂度摘要：O(N)

从先前使用 HIMPORT PREPARE 定义的字段集创建哈希，将字段集的字段名称与按位置提供的值配对。

必需参数

key

创建的关键。如果键已经存在，则会被覆盖。

fieldset-name

先前在同一连接上使用 HIMPORT PREPARE 定义的字段集的名称。

value [value ...]

字段值的给出顺序与字段集中声明的字段名称相同。值的数量必须等于字段集中的字段数量。

示例

> HIMPORT PREPARE u name email age
OK
> HIMPORT SET user:1 u alice a@example.com 30
OK
> HIMPORT SET user:2 u bob b@example.com 25
OK
> HGET user:1 name
"alice"
> HGET user:1 email
"a@example.com"
> HGET user:1 age
"30"

详细说明

HIMPORT SET 将 key 创建或覆盖为哈希，其字段是准备好的字段集的字段名称，每个字段与同一位置的值配对。值的数量必须与字段集中的字段数量匹配。

如果当前连接上尚未准备字段集，或者值的数量与字段集的字段计数不匹配，则该命令将返回错误。

以这种方式创建的键的行为与任何其他哈希完全相同，并且可以与所有现有哈希命令一起使用。由于它们共享一组固定的字段名称，因此 Redis 可以将它们存储为 紧凑哈希，保留字段名称的单个副本，以在许多键共享相同布局时减少内存。

Redis Software 与 Redis Cloud 兼容性

Redis 软件	Redis Cloud	说明
❌ 标准 ❌主动-主动	❌ 标准 ❌主动-主动

返回值

RESP2

简单字符串回复: OK.

RESP3

简单字符串回复: OK.

参见

HIMPORT PREPARE | HSET | HIMPORT DISCARD

资料来源：Redis 官方 HIMPORT SET 文档；中文内容参考 Redis 文档许可。