Redis - 哈希表HLEN、HSTRLEN、HINCRBY、HINCRBYFLOAT、HSCAN命令介绍

绝地灬酷狼 2022-12-23 04:59 86阅读 0赞

## Redis - 哈希表HLEN、HSTRLEN、HINCRBY、HINCRBYFLOAT、HSCAN命令介绍 ##

## HLEN ##

HLEN key

时间复杂度：O(1)

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

**演示**

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

当哈希表`key`不存在时，返回 0。  
![在这里插入图片描述][20201122180838141.png]

## HSTRLEN ##

HSTRLEN key field

可用版本：>= 3.2.0
    时间复杂度：O(1)

返回哈希表`key`中给定域`field`对应的字符串长度。

## 演示 ##

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

如果给定的哈希表`key`或者域`field`不存在， 那么命令返回 0 。  
![在这里插入图片描述][20201122181658665.png]  
![在这里插入图片描述][2020112218173148.png]

## HINCRBY ##

HINCRBY key field increment

可用版本：>= 2.0.0
    时间复杂度：O(1)

给哈希表`key`中的域`field`对应的值（可以转换成整数的字符串）加上增量`increment`。

**演示**

哈希表`key`中的域`field`对应的字符串不可以转换成整数，HINCRBY命令会报错。  
![在这里插入图片描述][20201122182236552.png]  
![在这里插入图片描述][20201122182357144.png]  
执行HINCRBY命令之后，命令会返回哈希表`key`中域`field`对应的新值。  
![在这里插入图片描述][20201122182437234.png]  
如果哈希表`key`中不存在`域field`，那么在执行命令之前，`域field`对应的值会被初始化为`0`。

![在这里插入图片描述][2020112218312715.png]  
如果哈希表`key`不存在，一个新的哈希表会被创建并执行HINCRBY命令。![在这里插入图片描述][20201122183108480.png]  
本操作的值被限制在`64`位有符号数字表示范围之内。

## HINCRBYFLOAT ##

HINCRBYFLOAT key field increment

可用版本：>= 2.6.0
    时间复杂度：O(1)

给哈希表`key`中的域`field`对应的值（可以转换成浮点数的字符串）加上浮点数增量`increment`。

**演示**

如果哈希表`key`中不存在域`field` ，那么HINCRBYFLOAT命令会先将域`field`的值设为`0`，然后再执行加法操作。  
![在这里插入图片描述][20201122183949240.png]  
如果哈希表`key`不存在，那么HINCRBYFLOAT命令会先创建一个哈希表，再创建域`field`，并且将域`field`对应的值设为`0` ，最后再执行加法操作。  
![在这里插入图片描述][20201122184312238.png]  
哈希表的HINCRBYFLOAT命令和字符串的INCRBYFLOAT命令类似：[Redis - 字符串INCR、INCRBY、INCRBYFLOAT、DECR、DECRBY命令介绍][Redis - _INCR_INCRBY_INCRBYFLOAT_DECR_DECRBY]，无论是哈希表`key`中域`field`对应的值还是增量`increment`， 都可以使用像`5e-1、5e2`这样的指数符号来表示。  
![在这里插入图片描述][20201122185124697.png]  
Redis中的整数和浮点数都是以字符串的形式保存，所以它们都属于字符串类型，这点要记住。

当哈希表`key`中域`field`对应的值或给定的增量`increment`不能转换成双精度浮点数时，HINCRBYFLOAT命令会报错。  
![在这里插入图片描述][20201122184838198.png]  
![在这里插入图片描述][20201122185005334.png]

## HSCAN ##

HSCAN key cursor [MATCH pattern] [COUNT count]

可用版本： >= 2.8.0
    时间复杂度：增量式迭代命令每次执行的复杂度为 O(1) ， 对数据集进行一次完整迭代的复杂度为 O(N) ， 其中 N 为数据集中的元素数量。

HSCAN命令用于增量式迭代哈希表中的键值对。

**选项**

*  MATCH ：MATCH选项为增量式迭代命令提供一个哈希表中键的模式参数， 让命令只返回和给定模式参数相匹配的键值对， 这一点可以通过在执行增量式迭代命令时， 通过给定`MATCH <pattern>`参数来实现，在下面会进行演示。
 *  COUNT：COUNT选项的作用就是让用户告知迭代命令， 在每次迭代中应该从数据集里返回多少元素。但COUNT选项只是对增量式迭代命令的一种**提示**（并不一定会遵守）。COUNT参数的默认值为`10` 。用户可以在每次迭代中按自己的需要随意改变COUNT参数的值， 只要记得将上次迭代返回的游标用到下次迭代里面就可以了。

**演示**

HSCAN命令是一个基于游标的迭代器，HSCAN命令每次被调用之后， 都会向用户返回一个新的游标， 用户在下次迭代时需要使用这个新游标作为HSCAN命令的游标参数， 以此来延续之前的迭代过程。

当HSCAN命令的游标参数被设置为`0`时， 服务器将开始一次新的迭代， 而当服务器向用户返回值为`0`的游标时， 表示迭代已结束。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM3OTYwNjAz_size_16_color_FFFFFF_t_70]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM3OTYwNjAz_size_16_color_FFFFFF_t_70 1]

hscan hash 0 match key1*

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM3OTYwNjAz_size_16_color_FFFFFF_t_70 2]  
我这里设置`count`参数没有生效。网上给的原因是：

> 这的确是个坑，HSCAN命令是为了处理大量数据而设计的，可能也是因为这个原因，在数据量较少的情况下，count参数并不会生效，具体阈值是多少并没有实际测验过。

所以这也说明了，COUNT选项只是对增量式迭代命令的一种**提示**（并不一定会遵守）。

Redis中哈希表的HLEN、HSTRLEN、HINCRBY、HINCRBYFLOAT、HSCAN命令就介绍到这里。

写博客是博主记录自己的学习过程，如果有错误，请指正，谢谢！

[20201122181121495.png]: /images/20221120/b2779a9ba0814a08bdff1788e5f65e7d.png
[20201122180838141.png]: /images/20221120/431d538b7e394491b11b5c6d2b431414.png
[20201122181508128.png]: /images/20221120/1431e445330c4b73ba6d22867c336bef.png
[20201122181658665.png]: /images/20221120/abcbcc4c10824caebae7a2c9532e8e81.png
[2020112218173148.png]: /images/20221120/ec56d815e168461f80d2cbec1b73e9ee.png
[20201122182236552.png]: /images/20221120/fd78fbe2355e4083b6ca4f8cdd474699.png
[20201122182357144.png]: /images/20221120/d78e7afebad24fd89544d0059a3e1cfb.png
[20201122182437234.png]: /images/20221120/d122b6605d5148b2a114725652be84aa.png
[2020112218312715.png]: /images/20221120/cbeb733d93f948c99c7c89217929774f.png
[20201122183108480.png]: /images/20221120/c4ecd32a162e43bda7aaaf3b8d4ef84c.png
[20201122183949240.png]: /images/20221120/02cb0a8467234a9ab2dbbecf9684f9ae.png
[20201122184312238.png]: /images/20221120/7845b4045c694028821c937623edf166.png
[Redis - _INCR_INCRBY_INCRBYFLOAT_DECR_DECRBY]: https://kaven.blog.csdn.net/article/details/109826264
[20201122185124697.png]: /images/20221120/9edbfa066f114daeb944455d2d835560.png
[20201122184838198.png]: /images/20221120/e7185b8468ef4829848598fcabb30098.png
[20201122185005334.png]: /images/20221120/73195627707b439587cb7c6cc5633ea0.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM3OTYwNjAz_size_16_color_FFFFFF_t_70]: /images/20221120/98f579d5d19d4a3b9d5fa95ad586fc60.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM3OTYwNjAz_size_16_color_FFFFFF_t_70 1]: /images/20221120/ab112910b1014744a79439024b352bc1.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM3OTYwNjAz_size_16_color_FFFFFF_t_70 2]: /images/20221120/a1f02c75d29f434b9abdae962c98c811.png