Redis五大数据类型之Hash操作命令

柔光的暖阳◎ 2022-10-16 08:54 293阅读 0赞

### Redis五大数据类型之Hash操作命令 ###

*  一、常用命令
 *   *  1.1 HSET hash field value
     *  1.2 HSETNX hash field value
     *  1.3 HGET hash field
     *  1.4 HEXISTS hash field
     *  1.5 HDEL key field \[field …\]
     *  1.6 HLEN key
     *  1.7 HSTRLEN key field
     *  1.8 HINCRBY key field increment
     *  1.9 HINCRBYFLOAT key field increment
     *  1.10 HMSET key field value \[field value …\]
     *  1.11 HMGET key field \[field …\]
     *  1.12 HKEYS key
     *  1.13 HVALS key
     *  1.14 HGETALL key
     *  1.15 HSCAN key cursor \[MATCH pattern\] \[COUNT count\]
 *  二、实操

# 一、常用命令 #

## 1.1 HSET hash field value ##

将哈希表 hash 中域 field 的值设置为 value 。  
如果给定的哈希表并不存在， 那么一个新的哈希表将被创建并执行 HSET 操作。  
如果域 field 已经存在于哈希表中， 那么它的旧值将被新值 value 覆盖。  
**返回值**：当 HSET 命令在哈希表中新创建 field 域并成功为它设置值时， 命令返回 1 ； 如果域 field 已经存在于哈希表， 并且 HSET 命令成功使用新值覆盖了它的旧值， 那么命令返回 0 。

## 1.2 HSETNX hash field value ##

当且仅当域 field 尚未存在于哈希表的情况下， 将它的值设置为 value 。  
如果给定域已经存在于哈希表当中， 那么命令将放弃执行设置操作。  
如果哈希表 hash 不存在， 那么一个新的哈希表将被创建并执行 HSETNX 命令。  
**返回值**：HSETNX 命令在设置成功时返回 1 ， 在给定域已经存在而放弃执行设置操作时返回 0 。

## 1.3 HGET hash field ##

返回哈希表中给定域的值。  
如果给定域不存在于哈希表中， 又或者给定的哈希表并不存在， 那么命令返回 nil 。

## 1.4 HEXISTS hash field ##

检查给定域 field 是否存在于哈希表 hash 当中。  
返回值：HEXISTS 命令在给定域存在时返回 1 ， 在给定域不存在时返回 0 。

## 1.5 HDEL key field \[field …\] ##

删除哈希表 key 中的一个或多个指定域，不存在的域将被忽略。  
返回值：被成功移除的域的数量，不包括被忽略的域

## 1.6 HLEN key ##

返回哈希表 key 中域的数量。  
返回值：哈希表中域的数量。当 key 不存在时，返回 0 。

## 1.7 HSTRLEN key field ##

返回哈希表 key 中， 与给定域 field 相关联的值的字符串长度（string length）。  
如果给定的键或者域不存在， 那么命令返回 0 。  
返回值：一个整数

## 1.8 HINCRBY key field increment ##

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

> 增量也可以为负数，相当于对给定域进行减法操作。 如果 key 不存在，一个新的哈希表被创建并执行 HINCRBY 命令。 如果域 field  
> 不存在，那么在执行命令前，域的值被初始化为 0 。 对一个储存字符串值的域 field 执行 HINCRBY 命令将造成一个错误。  
> 本操作的值被限制在 64 位(bit)有符号数字表示之内。

## 1.9 HINCRBYFLOAT key field increment ##

为哈希表 key 中的域 field 加上浮点数增量 increment 。

> 如果哈希表中没有域 field ，那么 HINCRBYFLOAT 会先将域 field 的值设为 0 ，然后再执行加法操作。 如果键 key  
> 不存在，那么 HINCRBYFLOAT 会先创建一个哈希表，再创建域 field ，最后再执行加法操作。

当以下任意一个条件发生时，返回一个错误：

*  域 field 的值不是字符串类型(因为 redis 中的数字和浮点数都以字符串的形式保存，所以它们都属于字符串类型）
 *  域 field 当前的值或给定的增量 increment 不能解释(parse)为双精度浮点数(double precision floating point number)  
    返回值：执行加法操作之后 field 域的值。

## 1.10 HMSET key field value \[field value …\] ##

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

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

**返回值：**  
如果命令执行成功，返回 OK 。  
当 key 不是哈希表(hash)类型时，返回一个错误。

## 1.11 HMGET key field \[field …\] ##

返回哈希表 key 中，一个或多个给定域的值。

> 如果给定的域不存在于哈希表，那么返回一个 nil 值。 因为不存在的 key 被当作一个空哈希表来处理，所以对一个不存在的 key 进行  
> HMGET 操作将返回一个只带有 nil 值的表。

## 1.12 HKEYS key ##

返回哈希表 key 中的所有域。  
**返回值**：一个包含哈希表中所有域的表。  
当 key 不存在时，返回一个空表。

## 1.13 HVALS key ##

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

## 1.14 HGETALL key ##

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

## 1.15 HSCAN key cursor \[MATCH pattern\] \[COUNT count\] ##

迭代哈希表中的键值对

# 二、实操 #

将hash表user中域id值设为11

hset user id 11

![在这里插入图片描述][2021052821354938.png]  
查看设置的id

hget user id

![在这里插入图片描述][2021052821361813.png]  
再将hash表user的name域设置z3

hset user name z3

![在这里插入图片描述][20210528213657200.png]  
同时将多个 field-value (域-值)对设置到哈希表 key 中。

hmset customer id 11 name li4 age 26

查看

hmget customer id name age

![在这里插入图片描述][20210528213806477.png]  
返回哈希表 customer 中，所有的域和值。

HGETALL customer

![在这里插入图片描述][20210528213848416.png]

删除hash表user的name域

hdel user name

![在这里插入图片描述][2021052821391381.png]  
返回Hash表user和customer中域的数量

hlen user
    hlen customer

![在这里插入图片描述][2021052821402147.png]  
检查域id和email是否存在哈希表customer中

HEXISTS customer id

![在这里插入图片描述][2021052821412518.png]

HEXISTS customer email

![在这里插入图片描述][20210528214139526.png]  
返回hash表customer中的所有域

hkeys customer

![在这里插入图片描述][20210528214214608.png]  
返回哈希表customer中所有域的值

HVALS customer

![在这里插入图片描述][20210528214302784.png]  
为哈希表 customer 中的域 age 的值加上增量2 。

HINCRBY customer age 2

![在这里插入图片描述][20210528214348627.png]  
为哈希表customer再加一个域score

hset customer score 91.5

![在这里插入图片描述][20210528214540130.png]

然后再给score增加0.5

HINCRBYFLOAT customer score 0.5

![在这里插入图片描述][20210528214548568.png]  
当且仅当域 age尚未存在于哈希表的情况下， 将它的值设置为25

hsetnx customer age 25

由于存在域age,所以操作失败  
![在这里插入图片描述][20210528214634139.png]  
当且仅当域 email尚未存在于哈希表的情况下， 将它的值设置为abc@126.com

hsetnx customer email abc@126.com

由于哈希表customer中不存在域email，所以设置成功  
![在这里插入图片描述][20210528214719335.png]

[2021052821354938.png]: /images/20221014/5fd2793e50d34f7da505c1252cebf65e.png
[2021052821361813.png]: /images/20221014/73256ce58ac04b79adb6d343b0817109.png
[20210528213657200.png]: /images/20221014/c66944879d9843feaaf74e8872c5f063.png
[20210528213806477.png]: /images/20221014/f41bdb500d86446a8fe00bf4c25a9cd0.png
[20210528213848416.png]: /images/20221014/ea1e1d743ba8429681187b27f764ed7a.png
[2021052821391381.png]: /images/20221014/4a4a6ba1f1634ad6aa8dfe5ead2c71e7.png
[2021052821402147.png]: /images/20221014/91ec00a068b0431caa9a2cb1b1d8da96.png
[2021052821412518.png]: /images/20221014/c59523b3a5484d1f82cbef4e08cef103.png
[20210528214139526.png]: /images/20221014/17fac0659c394d41a0a39552664d8285.png
[20210528214214608.png]: /images/20221014/978240911a954d6d9ec02e8ac9928261.png
[20210528214302784.png]: /images/20221014/048784227bc74dc88651dc6fbe427324.png
[20210528214348627.png]: /images/20221014/a43191a7f3d545739bfbdfa7a9c3fc48.png
[20210528214540130.png]: /images/20221014/8a7b2a17a8554fae922dfe95f903728f.png
[20210528214548568.png]: /images/20221014/902d1e1d889843ed81609eb7f838dc7c.png
[20210528214634139.png]: /images/20221014/50a8c03f95bb4d40b8396a69d163dba4.png
[20210528214719335.png]: /images/20221014/9a9205748f2046d2b4546f8e33795c06.png