Redis 哈希表操作实战（全）

目录

HSET 添加

HSETNX 添加

HMSET 批量添加

HGET 获取元素

HGETALL 获取所有

HMGET 批量查询

HEXISTS 判断是否存在

HINCRBY 增加整数

HINCRBYFLOAT 添加浮点数

HLEN 查Field数量

HKEYS 查所有Field

HVALS 查所有Field值

HSCAN 迭代

HDEL 删除Field

---

HSET 添加

HSET key field value：将哈希表 key 中的域 field 的值设为 value。

• key不存在，创建新的哈希表并hset操作。
• key存在，覆盖旧值。

127.0.0.1:6379> flushdb
OK
 
# field不存在，hset成功返回 1
127.0.0.1:6379> hset person name 'cxian'
(integer) 1
127.0.0.1:6379> hset person age '22'
(integer) 1
 
# field已存在并覆盖值，hset成功返回 0
127.0.0.1:6379> hset person age '25'
(integer) 0
127.0.0.1:6379> set name 100
OK
 
# 对已存在的key执行hset报错
127.0.0.1:6379> hset name high 1.75
(error) WRONGTYPE Operation against a key holding the wrong kind of value

时间复试度为O(1)。

返回值：

• 返回1：field不存在并值设置成功。
• 返回0：field已存在并覆盖旧值成功。
• 报错：key不为hash类型。

HSETNX 添加

HSETNX key field value：将哈希表 key 中的域 field 的值设置为 value。

• 若field已存在，该操作无效。

127.0.0.1:6379> flushdb
OK
127.0.0.1:6379> hsetnx person age 10
(integer) 1
 
# age已存在
127.0.0.1:6379> hsetnx person age 12
(integer) 0

时间复杂度O(1)。

设置成功返回1，field已存在则操作不成功返回0。

HMSET 批量添加

HMSET key field value [field value ...]：同时将多个 field-value (域-值)对设置到哈希表 key 中。

• 此命令会覆盖哈希表中已存在的域。
• 如果 key 不存在，一个空哈希表被创建并执行 HMSET 操作。

127.0.0.1:6379> flushdb
OK
127.0.0.1:6379> hmset person age 12 name cxian
OK
127.0.0.1:6379> hmget person age name
1) "12"
2) "cxian"

时间复杂度O(N)，N为field-value的数量。

执行成功返回OK，当key不是hash表类型时报错。

HGET 获取元素

HGET key field：返回哈希表 key 中给定域 field 的值。

127.0.0.1:6379> flushdb
OK
127.0.0.1:6379> hset person age 88
(integer) 1
127.0.0.1:6379> hget person age
"88"
 
# key不存在或field不存在
127.0.0.1:6379> hget person1 age
(nil)
127.0.0.1:6379> hget person age1
(nil)

时间复杂度O(1)。

返回给定域的值。

• key不存在或field不存在，返回nil。

HGETALL 获取所有

HGETALL key：返回哈希表 key 中，所有的域和值。

• 返回值里，紧跟每个域名(field name)之后是域的值(value)，所以返回值的长度是哈希表大小的两倍。

127.0.0.1:6379> flushdb
OK
127.0.0.1:6379> hset person age 88
(integer) 1
127.0.0.1:6379> hget person age
"88"
127.0.0.1:6379> hset person name cxian
(integer) 1
127.0.0.1:6379> hgetall person
1) "age"       # field
2) "88"        # value
3) "name"
4) "cxian"
 
# key不存在
127.0.0.1:6379> hgetall person1
(empty array)

时间复杂度O(N)，N为哈希表的大小。

以列表形式返回哈希表的域和域的值。

• 若key不存在返回空列表。

HMGET 批量查询

HMGET key field [field ...]：返回哈希表 key 中，一个或多个给定域的值。

• 域不存在于哈希表，那么返回一个 nil 值。
• 若key不存在，列表返回对应field数量的nil值。

127.0.0.1:6379> flushdb
OK
127.0.0.1:6379> hset person age 88
(integer) 1
127.0.0.1:6379> hget person age
"88"
 
127.0.0.1:6379> hmget person age name address
1) "88"
2) "cxian"
3) (nil)
 
# key不存在
127.0.0.1:6379> hmget person1 age name
1) (nil)
2) (nil)

时间复杂度O(N)，N为field的数量。

返回一个包含多个给定域的关联值的表。

• 表值的排列顺序和给定域参数的请求顺序一样。

HEXISTS 判断是否存在

HEXISTS key field：查看哈希表 key 中，给定域 field 是否存在。

127.0.0.1:6379> flushdb
OK
127.0.0.1:6379> hset person age 88
 
127.0.0.1:6379> hexists person age
(integer) 1
 
# 不存在field或不存在的key
127.0.0.1:6379> hexists person age1
(integer) 0
127.0.0.1:6379> hexists person1 age
(integer) 0

时间复杂度为O(1)。如果key和field都存在返回1，否则返回0。

HINCRBY 增加整数

HINCRBY key field increment：为哈希表 key 中的域 field 的值加上增量 increment。

• 若increment为负数相当于相减。
• 若key或field不存在，创建（默认值为0）并执行hincrby命令。
• 若field对应值不为数字，则报错。
• 本操作的值被限制在 64 位(bit)有符号数字表示之内。

127.0.0.1:6379> flushdb
OK
127.0.0.1:6379> keys *
(empty array)
 
# key和field不存在
127.0.0.1:6379> hincrby person age 22
(integer) 22
127.0.0.1:6379> hget person age
"22"
 
# increment为负数
127.0.0.1:6379> hincrby person age -10
(integer) 12
127.0.0.1:6379> hget person age
"12"
127.0.0.1:6379> 
127.0.0.1:6379> hset person name cxian
(integer) 1
 
# field对应值不为数字
127.0.0.1:6379> hincrby person name 12
(error) ERR hash value is not an integer

时间复杂度O(1)。

返回执行hincrby之后field对应的值。

HINCRBYFLOAT 添加浮点数

HINCRBYFLOAT key field increment

• 与HINCRBY key field increment相似。
• 不同点是HINCRBYFLOAT的increment必须是双精度浮点数且可以用指数符号形式表示（如2.0e7 、 3e5 、 90e-2等）。

127.0.0.1:6379> hincrbyfloat person age 23.8
"35.8"
127.0.0.1:6379> hincrbyfloat person age -8.9
"26.9"

HLEN 查Field数量

HLEN key：返回哈希表 key 中域的数量。

127.0.0.1:6379> flushdb
OK
127.0.0.1:6379> keys *
(empty array)
127.0.0.1:6379> hmset person age 23 name cxian
OK
127.0.0.1:6379> hlen person
(integer) 2

时间复杂度O(1)。

返回哈希表中field的数量。

• key不存在时返回0。

HKEYS 查所有Field

HKEYS key：返回哈希表 key 中的所有field。

127.0.0.1:6379> flushdb
OK
127.0.0.1:6379> keys *
(empty array)
127.0.0.1:6379> hmset person age 23 name cxian
OK
127.0.0.1:6379> hlen person
(integer) 2
127.0.0.1:6379> hkeys person
1) "age"
2) "name"
 
# key不存在
127.0.0.1:6379> hkeys person1
(empty array)

时间复杂度为O(N)，N为field的数量。

一个包含哈希表中所有域的表。

• 当key不存在时返回空表。

HVALS 查所有Field值

HVALS key：返回哈希表 key 中所有域的值。

127.0.0.1:6379> flushdb
OK
127.0.0.1:6379> keys *
(empty array)
127.0.0.1:6379> hmset person age 23 name cxian
OK
 
127.0.0.1:6379> hvals person
1) "23"
2) "cxian"
 
# key不存在
127.0.0.1:6379> hvals person1
(empty array)
127.0.0.1:6379> 

时间复杂度为O(N)，N为field数量。

返回一个包含哈希表中所有值的表。

• 当key不存在时返回空表。

HSCAN 迭代

HSCAN key cursor [MATCH pattern] [COUNT count]：迭代哈希键中的键值对。

• 详见SCAN命令操作实战。

HDEL 删除Field

HDEL key field [field ...]：删除哈希表 key 中的一个或多个指定域，不存在的域将被忽略。

127.0.0.1:6379> hgetall person
1) "age"
2) "23"
3) "name"
4) "cxian"
127.0.0.1:6379> hdel person age
(integer) 1
 
# field不存在 或 key不存在
127.0.0.1:6379> hdel person age1
(integer) 0
 
 
127.0.0.1:6379> hgetall person
1) "name"
2) "cxian"

时间复杂度O(N)，N为field的数量。

返回被移除的field的数量。