在之前的文章中,我们介绍了Redis中有关于字符串(string)以及列表(list)类型的命令,今天我们来介绍Redis中另外一种类型——哈希表(hash)。哈希表还被称之为散列、字典等,我们在本文中便称它为哈希表。它是一个字符串类型field(下文中称之为域)与其关联的值(同样为字符串类型)的映射表。

哈希表的命令与字符串及键操作命令相似,其底层结构的实现也与Redis键空间相类似,所以文中在碰到与之前相类似的命令时将只做比较简单的介绍。

HSET

HSET命令用于设置哈希表中指定域的值,并返回新添加的域的数量。若哈希表中对应的域已存在则将覆盖其值。在Redis 4.0.0及以上版本中,HSET命令允许同时设置一个或多个域的值,若版本低于4.0.0可使用下文将会介绍到的HMSET命令。

HSET key field value [field value ...]

示例

redis> HSET students s01 "Zhang San" s02 "Li Si"
(integer) 2
redis> HGET students s02
"Li Si"
redis> HSET students s02 "Wang Wu" s003 "Zhao Liu"
(integer) 1
redis> HGET students s02
"Wang Wu"

HGET

HGET命令用于获取哈希表中指定域对应的值,当哈希表不存在或哈希表中不存在指定名称的域时将返回nil

HGET key field

示例

redis> HSET students s01 "Zhang San" s02 "Li Si"
(integer) 2
redis> HGET students s02
"Li Si"
redis> HGET students s03
(nil)

HLEN

HLEN命令用户获取哈希表中存在的域的数量,当哈希表不存在时将返回0

HLEN key

示例

redis> HSET students s01 "Zhang San" s02 "Li Si"
(integer) 2
redis> HLEN students
(integer) 2
redis> HSET students s03 "Wang Wu"
(integer) 2
redis> HLEN students
(integer) 3

HDEL

HDEL命令用于移除哈希表中指定的域(Redis 2.4以上的版本支持同时移除一个或多个),并返回实际移除的域的个数。当指定的域不存在时将忽略该域不执行移除的操作;若哈希表不存在,将认为其为一个空哈希表并返回0

HDEL key field [field ...]

示例

redis> HSET students s01 "Zhang San" s02 "Li Si" s3 "Wang Wu"
(integer) 3
redis> HLEN students
(integer) 3
redis> HDEL students s02 s03
(integer) 2
redis> HLEN students
(integer) 1
redus> HDEL student s02 s03
(integer) 0

HEXISTS

HEXISTS命令用于获取哈希表中指定名称的域是否存在。

HEXISTS key field

当哈希表中存在指定域时返回1;当哈希表中不包含指定域或哈希表不存在时,返回0

示例

redis> HSET students s01 "Zhang San" s02 "Li Si"
(integer) 2
redis> HEXISTS student s01
(integer) 1
redis> HEXISTS student s03
(integer) 0

HSETNX

HSETNX命令用于在哈希表中指定域不存在时设置其值,若域已存在将不执行操作。

HSETNX key field value

当域为一个新域且成功执行设置其值的操作后,将返回1。若在哈希表中域已存在,则不进行操作并返回0

示例

redis> HSETNX students s01 "Zhang San"
(integer) 1
redis> HSETNX students s01 "Li Si"
(integer) 0
redis> HGET students s01
"Zhang San"

HMSET

HMSET命令用于设置哈希表中一个或多个域的值。执行操作时若域已存在,将覆盖原先的值;若域不存在,将创建并设置其值。

HMSET key field value [field value ...]

HMSET命令在后续的版本中可能会被移除,请使用HSET命令代替。

示例

redis> HMSET students s01 "Zhang San" s02 "Li Si"
OK
redus> HGET students s01
"Zhang San"
redis> HGET students s02
"Li Si"

HMGET

HMGET命令用于获取哈希表中一个或多个域的值,并已列表的形式按给定的域名顺序将其返回。

HMGET key field [field ...]

当指定域名不存在时,返回的列表中对应的值将为nil。若哈希表不存在,执行命令时将会视为一个空哈希表,并返回nil值的列表。

示例

redis> HSET students s01 "Zhang San" s03 "Li Si"
(integer) 2
redis> HMGET students s01 s02 s03
1) "Zhang San"
2) (nil)
3) "Li Si"

HGETALL

HGETALL命令用于获取哈希表中所有域的域名及其对应的值,并以列表的形式将结果返回。返回的列表将以域名、值交替的形式呈现,其长度固定为哈希表大小的两倍。当哈希不存在时,将视为空哈希表并返回一个空白的队列。

HGETALL key

示例

# 不存在的哈希表
redis> HGETALL students
(empty array)
redis> HSET students s01 "Zhang San" s02 "Li Si"
(integer) 2
redis> HGETALL students
1) "s01"
2) "Zhang San"
3) "s02"
4) "Li Si"

HKEYS

HKEYS命运用于获取指定哈希表中的所有键值对的键名,并以列表的形式返回。当哈希表为空时返回空列表。

HKEYS key

示例

redis> HSET students s01 "Zhang San" s02 "Li Si"
(integer) 2
redis> HKEYS students
1) "s01"
2) "s02"
# 不存在的哈希表
redis> HKEYS cards
(empty array)

HVALS

HVALS命运用于获取指定哈希表中的所有键值对的键值,并以列表的形式返回。当哈希表为空时返回空列表。

HVALS key

示例

redis> HSET students s01 "Zhang San" s02 "Li Si"
(integer) 2
redis> HVALS students
1) "Zhang San"
2) "Li Si"
# 不存在的哈希表
redis> HVALS cards
(empty array)

HSCAN

HSCAN命令与前文中介绍过的SCAN命令类似,它用于增量式的迭代获取哈希表中的所有域,并返回其域名称及其值。相对于上文中介绍的HGETALLHKEYS以及HVALS命令,在哈希表中域数量较多的情况下不会造成阻塞,进而相对更加安全。

HSCAN key cursor [MATCH pattern] [COUNT count]

SCAN命令相同,HSCAN命令是一个基于游标cursor的迭代器,每次执行后将会返回一个新的游标,以作为下一轮迭代的游标参数。一次的迭代以游标0为开始,并在返回游标0时结束,称之为一次完整的迭代。同样,HSCAN命令也接受MATCHCOUNT两个参数,用于提供模式匹配的功能及限制获取的数量。

关于更多HSCAN命令的用法,可参考SCAN命令。

示例

redis> HSCAN students 0
1) "0"
2) (empty array)
redis> HSET students s01 "Zhang San" s02 "Li Si"
(integer) 2
redis> HSCAN students 0
1) "0"
2) 1) "s01"
   2) "Zhang San"
   3) "s02"
   4) "Li Si"

HINCRBY

HINCRBY命令与前文中介绍的与INCRBY命令类似,它用于对哈希表中指定域的值进行递增的操作,并返回执行递增操作后该域的值。若指定的域不存在,将在执行操作前将其值设置为0;若指定的哈希表不存在,则将创建对应的哈希表并执行操作。当指定的域的值无法表示为数值时,将返回错误。

INCRBY命令相同,HINCRBY所支持的值为64位的有符号整数。若incremnet的值为负数值,其操作等同于做递减操作。

HINCRBY key field increment

示例

# 对不存在的键值对执行HINCRBY命令将创建对应的哈希表
redis> HINCRBY user rank 1
(integer) 1
redis> HINCRBY user rank 3
(integer) 4
redis> HSCAN user 0
1) "0"
2) 1) "rank"
   2) "4"
# 对非数值进行操作
redis> HSET user name "John Doe"
(integer) 1
redis> HINCRBY user name 1
(error) ERR hash value is not an integer

HINCRBYFLOAT

HINCRBYFLOAT命令用于将哈希表中对应域的值解释为浮点数类型,执行递增指定浮点数值的操作,并返回执行递增后的值。HINCRBYFLOAT命令使用与INCRBYFLOAT命令相似,可参考INCRBYFLOAT命令了解更多。

HINCRBYFLOAT key field increment

示例

redis> HINCRBYFLOAT user balance 100.5
"100.5"
redis> HINCRBYFLOAT user balance 15.5
"116"
redis> HINCRBYFLOAT user balance -16
"100"

HSTRLEN

HSTRLEN命令用于获取哈希表中指定域的值的长度,若哈希表或域不存在则返回0

HSTRLEN key field

示例

redis> HSET students s01 "Zhang San" s02 "Li Si"
(integer) 2
redis> HSTRLEN students s01
(integer) 9
redis> HSTRLEN students s02
(integer) 5
# 不存在的域
redis> HSTRLEN students s03
(integer) 0

结束语

至此,我们已经介绍了Redis中包括字符串、哈希表、列表以及部分键操作命令在内的命令,在后续的文章中我们将继续介绍Redis中有关集合、有序集合类型等命令。

参考资料