redis基本类型之哈希

欢迎拜访：雾里看山-CSDN博客
本篇主题：redis的基本类型之哈希
发布时间：2025.8.16
隶属专栏：redis

基本介绍

几乎所有的主流编程语言都提供了哈希（hash）类型，它们的叫法可能是哈希、字典、关联数组、映射。在 Redis 中，哈希类型是指值本身又是一个键值对结构，形如 key = "key"，value = { {field1, value1 }, ..., {fieldN, valueN } }，Redis 键值对和哈希类型二者的关系可以用下图来表示。

哈希类型中的映射关系通常称为 field-value，用于区分 Redis 整体的键值对（key-value），注意这里的 value 是指 field 对应的值，不是键（key）对应的值，请注意 value 在不同上下文的作用。

常用命令

hset

功能： 设置 hash 中指定的字段（field）的值（value）。
语法：

HSET key field value [field value ...]

命令有效版本： 2.0.0 之后
时间复杂度： 插入一组 field 为 O(1), 插入 N 组 field 为 O(N)
返回值： 添加的字段的个数。
示例：

redis> HSET myhash field1 "Hello"
(integer) 1
redis> HGET myhash field1
"Hello

hget

功能： 获取 hash 中指定字段的值。
语法：

HGET key field

命令有效版本： 2.0.0 之后
时间复杂度： O(1)
返回值： 字段对应的值或者 nil。
示例：

redis> HSET myhash field1 "foo"
(integer) 1
redis> HGET myhash field1
"foo"
redis> HGET myhash field2
(nil)

hexists

功能： 判断 hash 中是否有指定的字段。
语法：

HEXISTS key field

命令有效版本： 2.0.0 之后
时间复杂度： O(1)
返回值： 1 表是存在，0 表示不存在。
示例：

redis> HSET myhash field1 "foo"
(integer) 1
redis> HEXISTS myhash field1
(integer) 1
redis> HEXISTS myhash field2
(integer) 0

hdel

功能： 删除 hash 中指定的字段。
语法：

HDEL key field [field ...]

命令有效版本： 2.0.0 之后
时间复杂度： 删除一个元素为 O(1). 删除 N 个元素为 O(N).
返回值： 本次操作删除的字段个数。
示例：

redis> HSET myhash field1 "foo"
(integer) 1
redis> HDEL myhash field1
(integer) 1
redis> HDEL myhash field2
(integer) 0

hkeys

功能： 获取 hash 中的所有字段。
语法：

HKEYS key

命令有效版本： 2.0.0 之后
时间复杂度： O(N), N 为 field 的个数.
**返回值：**字段列表。
示例：

redis> HSET myhash field1 "Hello"
(integer) 1
redis> HSET myhash field2 "World"
(integer) 1
redis> HKEYS myhash
1) "field1"
2) "field2"

hvals

功能： 获取 hash 中的所有的值。
语法：

HVALS key

命令有效版本： 2.0.0 之后
时间复杂度： O(N), N 为 field 的个数.
返回值： 所有的值。
示例：

redis> HSET myhash field1 "Hello"
(integer) 1
redis> HSET myhash field2 "World"
(integer) 1
redis> HVALS myhash
1) "Hello"
2) "World"

hgetall

功能： 获取 hash 中的所有字段以及对应的值。
语法：

HGETALL key

命令有效版本： 2.0.0 之后
时间复杂度： O(N), N 为 field 的个数.
返回值： 字段和对应的值。
示例：

redis> HSET myhash field1 "Hello"
(integer) 1
redis> HSET myhash field2 "World"
(integer) 1
redis> HGETALL myhash
1) "field1"
2) "Hello"
3) "field2"
4) "World"

hmget

功能： 一次获取 hash 中多个字段的值。
语法：

HMGET key field [field ...]

命令有效版本： 2.0.0 之后
时间复杂度： 只查询一个元素为 O(1), 查询多个元素为 O(N), N 为查询元素个数.
返回值： 字段对应的值或者 nil。
示例：

redis> HSET myhash field1 "Hello"
(integer) 1
redis> HSET myhash field2 "World"
(integer) 1
redis> HMGET myhash field1 field2 nofield
1) "Hello"
2) "World"
3) (nil)

在使用 hgetall 时，如果哈希元素个数比较多，会存在阻塞 Redis 的可能。如果开发人员只需要获取部分 field，可以使用 hmget，如果一定要获取全部 field，可以尝试使用 hscan命令，该命令采用渐进式遍历哈希类型，hscan 会在后续章节介绍。

hlen

功能： 获取 hash 中的所有字段的个数。
语法：

HLEN key

命令有效版本： 2.0.0 之后
时间复杂度： O(1)
返回值： 字段个数。
示例：

redis> HSET myhash field1 "Hello"
(integer) 1
redis> HSET myhash field2 "World"
(integer) 1
redis> HLEN myhash
(integer) 2

hsetnx

功能： 在字段不存在的情况下，设置 hash 中的字段和值。
语法：

HSETNX key field value

命令有效版本： 2.0.0 之后
时间复杂度： O(1)
返回值： 1 表示设置成功，0 表示失败。
示例：

redis> HSETNX myhash field "Hello"
(integer) 1
redis> HSETNX myhash field "World"
(integer) 0
redis> HGET myhash field
"Hello"

hincrby

功能： 将 hash 中字段对应的数值添加指定的值。
语法：

HINCRBY key field increment

命令有效版本： 2.0.0 之后
时间复杂度： O(1)
返回值： 该字段变化之后的值。
示例：

redis> HSET myhash field 5
(integer) 1
redis> HINCRBY myhash field 1
(integer) 6
redis> HINCRBY myhash field -1
(integer) 5
redis> HINCRBY myhash field -10
(integer) -5

hincrbyfloat

功能： hincrby 的浮点数版本。
语法：

HINCRBYFLOAT key field increment

命令有效版本： 2.6.0 之后
时间复杂度： O(1)
返回值： 该字段变化之后的值。
示例：

redis> HSET mykey field 10.50
(integer) 1
redis> HINCRBYFLOAT mykey field 0.1
"10.6"
redis> HINCRBYFLOAT mykey field -5
"5.6"
redis> HSET mykey field 5.0e3
(integer) 0
redis> HINCRBYFLOAT mykey field 2.0e2
"5200"

内部编码

哈希的内部编码有两种：

• ziplist（压缩列表）：当哈希类型元素个数小于 hash-max-ziplist-entries 配置（默认 512 个）、同时所有值都小于 hash-max-ziplist-value 配置（默认 64 字节）时，Redis 会使用 ziplist 作为哈希的内部实现，ziplist 使用更加紧凑的结构实现多个元素的连续存储，所以在节省内存方面比hashtable 更加优秀。
• hashtable（哈希表）：当哈希类型无法满足 ziplist 的条件时，Redis 会使用 hashtable 作为哈希的内部实现，因为此时 ziplist 的读写效率会下降，而hashtable 的读写时间复杂度为 O(1)。

下面的示例演示了哈希类型的内部编码，以及响应的变化。

1. 当 field 个数比较少且没有大的 value 时，内部编码为 ziplist：

127.0.0.1:6379> hmset hashkey f1 v1 f2 v2
OK
127.0.0.1:6379> object encoding hashkey
"ziplist"

2. 当有 value 大于 64 字节时，内部编码会转换为 hashtable：

127.0.0.1:6379> hset hashkey f3 "one string is bigger than 64 bytes ... 省略..."
OK
127.0.0.1:6379> object encoding hashkey
"hashtable"

3. 当 field 个数超过 512 时，内部编码也会转换为 hashtable：

127.0.0.1:6379> hmset hashkey f1 v1 h2 v2 f3 v3 ... 省略 ... f513 v513
OK
127.0.0.1:6379> object encoding hashkey
"hashtable"

应用场景

下图为关系型数据表记录的两条用户信息，用户的属性表现为表的列，每条用户信息表现为行。如果映射关系表示这两个用户信息，则如下图所示。

关系型数据表保存用户信息:

映射关系表示用户信息：

相比于使用 JSON 格式的字符串缓存用户信息，哈希类型变得更加直观，并且在更新操作上变得更灵活。可以将每个用户的 id 定义为键后缀，多对 field-value 对应用户的各个属性，类似如下伪代码：

UserInfo getUserInfo(long uid) {// 根据 uid 得到 Redis 的键String key = "user:" + uid;// 尝试从 Redis 中获取对应的值userInfoMap = Redis 执⾏命令：hgetall key;// 如果缓存命中（hit）if (value != null) {// 将映射关系还原为对象形式UserInfo userInfo = 利⽤映射关系构建对象(userInfoMap);return userInfo;}// 如果缓存未命中（miss）// 从数据库中，根据 uid 获取⽤⼾信息UserInfo userInfo = MySQL 执⾏ SQL：select * from user_info where uid = 
<uid>// 如果表中没有 uid 对应的⽤⼾信息if (userInfo == null) {响应 404return null;}// 将缓存以哈希类型保存Redis 执⾏命令：hmset key name userInfo.name age userInfo.age city 
userInfo.city// 写⼊缓存，为了防⽌数据腐烂（rot），设置过期时间为 1 ⼩时（3600 秒）Redis 执⾏命令：expire key 3600// 返回⽤⼾信息return userInfo;
}

但是需要注意的是哈希类型和关系型数据库有两点不同之处：

• 哈希类型是稀疏的，而关系型数据库是完全结构化的，例如哈希类型每个键可以有不同的 field，而关系型数据库一旦添加新的列，所有行都要为其设置值，即使为 null，如图所示。
• 关系数据库可以做复杂的关系查询，而 Redis 去模拟关系型复杂查询，例如联表查询、聚合查询等基本不可能，维护成本高。

缓存方式对比

截至目前为止，我们已经能够用三种方法缓存用户信息，下面给出三种方案的实现方法和优缺点分析。

原生字符串类型

使用字符串类型，每个属性一个键。

set user:1:name James
set user:1:age 23
set user:1:city Beijing

优点： 实现简单，针对个别属性变更也很灵活。
缺点： 占用过多的键，内存占用量较大，同时用户信息在 Redis 中比较分散，缺少内聚性，所以这种方案基本没有实用性。

序列化字符串类型

例如 JSON 格式

set user:1 经过序列化后的⽤⼾对象字符串

优点： 针对总是以整体作为操作的信息比较合适，编程也简单。同时，如果序列化方案选择合适，内存的使用效率很高。
缺点： 本身序列化和反序列需要一定开销，同时如果总是操作个别属性则非常不灵活。

哈希类型

hmset user:1 name James age 23 city Beijing

优点： 简单、直观、灵活。尤其是针对信息的局部变更或者获取操作。
缺点： 需要控制哈希在 ziplist 和 hashtable 两种内部编码的转换，可能会造成内存的较大消耗。