Redis学习记录之命令Hash(十)

淡淡的烟草味﹌ 2022-08-19 11:24 230阅读 0赞

**1、HDEL**  
HDEL key field \[field …\]

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

在Redis2.4以下的版本里， HDEL 每次只能删除单个域，如果你需要在一个原子时间内删除多个域，请将命令包含在 MULTI / EXEC 块内。  
可用版本：  
2.0.0+

返回值:  
被成功移除的域的数量，不包括被忽略的域。  
**测试数据**

redis> HGETALL abbr  
1) “a”  
2) “apple”  
3) “b”  
4) “banana”  
5) “c”  
6) “cat”  
7) “d”  
8) “dog”

**删除单个域**

redis> HDEL abbr a  
(integer) 1

**删除不存在的域**

redis> HDEL abbr not-exists-field  
(integer) 0

**删除多个域**

redis> HDEL abbr b c  
(integer) 2

redis> HGETALL abbr  
1) “d”  
2) “dog”

**2、HEXISTS**  
HEXISTS key field

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

可用版本：  
2.0.0+

返回值：  
如果哈希表含有给定域，返回 1 。  
如果哈希表不含有给定域，或 key 不存在，返回 0 。  
redis> HEXISTS phone myphone  
(integer) 0

redis> HSET phone myphone nokia-1110  
(integer) 1

redis> HEXISTS phone myphone  
(integer) 1

**3、HGET**  
HGET key field

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

可用版本：  
2.0.0+

返回值：  
给定域的值。  
当给定域不存在或是给定 key 不存在时，返回 nil 。  
**域存在**

redis> HSET site redis redis.com  
(integer) 1

redis> HGET site redis  
“redis.com”

**域不存在**

redis> HGET site mysql  
(nil)

**4、HGETALL**  
HGETALL key

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

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

可用版本：  
2.0.0+

返回值：  
以列表形式返回哈希表的域和域的值。  
若 key 不存在，返回空列表。  
redis> HSET people jack “Jack Sparrow”  
(integer) 1

redis> HSET people gump “Forrest Gump”  
(integer) 1

redis> HGETALL people  
1) “jack” \# 域  
2) “Jack Sparrow” \# 值  
3) “gump”  
4) “Forrest Gump”

**5、HINCRBY**  
HINCRBY key field increment

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

增量也可以为负数，相当于对给定域进行减法操作。

如果 key 不存在，一个新的哈希表被创建并执行 HINCRBY 命令。

如果域 field 不存在，那么在执行命令前，域的值被初始化为 0 。

对一个储存字符串值的域 field 执行 HINCRBY 命令将造成一个错误。

本操作的值被限制在 64 位(bit)有符号数字表示之内。

可用版本：  
2.0.0+

返回值：  
执行 HINCRBY 命令之后，哈希表 key 中域 field 的值。  
**increment 为正数**

redis> HEXISTS counter page\_view \# 对空域进行设置  
(integer) 0

redis> HINCRBY counter page\_view 200  
(integer) 200

redis> HGET counter page\_view  
“200”

**increment 为负数**

redis> HGET counter page\_view  
“200”

redis> HINCRBY counter page\_view -50  
(integer) 150

redis> HGET counter page\_view  
“150”

**尝试对字符串值的域执行HINCRBY命令**

redis> HSET myhash string hello,world \# 设定一个字符串值  
(integer) 1

redis> HGET myhash string  
“hello,world”

redis> HINCRBY myhash string 1 \# 命令执行失败，错误。  
(error) ERR hash value is not an integer

redis> HGET myhash string \# 原值不变  
“hello,world”

**6、HINCRBYFLOAT**  
HINCRBYFLOAT key field increment

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

如果哈希表中没有域 field ，那么 HINCRBYFLOAT 会先将域 field 的值设为 0 ，然后再执行加法操作。

如果键 key 不存在，那么 HINCRBYFLOAT 会先创建一个哈希表，再创建域 field ，最后再执行加法操作。

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

域 field 的值不是字符串类型(因为 redis 中的数字和浮点数都以字符串的形式保存，所以它们都属于字符串类型）  
域 field 当前的值或给定的增量 increment 不能解释(parse)为双精度浮点数(double precision floating point number)  
HINCRBYFLOAT 命令的详细功能和 INCRBYFLOAT 命令类似，请查看 INCRBYFLOAT 命令获取更多相关信息。

可用版本：  
2.6.0+

返回值：  
执行加法操作之后 field 域的值。  
**值和增量都是普通小数**

redis> HSET mykey field 10.50  
(integer) 1  
redis> HINCRBYFLOAT mykey field 0.1  
“10.6”

**值和增量都是指数符号**

redis> HSET mykey field 5.0e3  
(integer) 0  
redis> HINCRBYFLOAT mykey field 2.0e2  
“5200”

**对不存在的键执行 HINCRBYFLOAT**

redis> EXISTS price  
(integer) 0  
redis> HINCRBYFLOAT price milk 3.5  
“3.5”  
redis> HGETALL price  
1) “milk”  
2) “3.5”

**对不存在的域进行 HINCRBYFLOAT**

redis> HGETALL price  
1) “milk”  
2) “3.5”  
redis> HINCRBYFLOAT price coffee 4.5 \# 新增 coffee 域  
“4.5”  
redis> HGETALL price  
1) “milk”  
2) “3.5”  
3) “coffee”  
4) “4.5”

**7、HKEYS**  
HKEYS key

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

可用版本：  
2.0.0+

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

redis> HMSET website google www.google.com yahoo www.yahoo.com  
OK

redis> HKEYS website  
1) “google”  
2) “yahoo”

**空哈希表/key不存在**

redis> EXISTS fake\_key  
(integer) 0

redis> HKEYS fake\_key  
(empty list or set)

**8、HLEN**  
HLEN key

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

返回值：  
哈希表中域的数量。  
当 key 不存在时，返回 0 。  
redis> HSET db redis redis.com  
(integer) 1

redis> HSET db mysql mysql.com  
(integer) 1

redis> HLEN db  
(integer) 2

redis> HSET db mongodb mongodb.org  
(integer) 1

redis> HLEN db  
(integer) 3

**9、HMGET**  
HMGET key field \[field …\]

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

如果给定的域不存在于哈希表，那么返回一个 nil 值。

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

可用版本：  
2.0.0+

返回值：  
一个包含多个给定域的关联值的表，表值的排列顺序和给定域参数的请求顺序一样。  
redis> HMSET pet dog “doudou” cat “nounou” \# 一次设置多个域  
OK

redis> HMGET pet dog cat fake\_pet \# 返回值的顺序和传入参数的顺序一样  
1) “doudou”  
2) “nounou”  
3) (nil) \# 不存在的域返回nil值

**10、HMSET**  
HMSET key field value \[field value …\]

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

此命令会覆盖哈希表中已存在的域。

如果 key 不存在，一个空哈希表被创建并执行 HMSET 操作。

可用版本：  
2.0.0+

返回值：  
如果命令执行成功，返回 OK 。  
当 key 不是哈希表(hash)类型时，返回一个错误。  
redis> HMSET website google www.google.com yahoo www.yahoo.com  
OK

redis> HGET website google  
“www.google.com”

redis> HGET website yahoo  
“www.yahoo.com”

**11、HSET**  
HSET key field value

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

如果 key 不存在，一个新的哈希表被创建并进行 HSET 操作。

如果域 field 已经存在于哈希表中，旧值将被覆盖。

可用版本：  
2.0.0+

返回值：  
如果 field 是哈希表中的一个新建域，并且值设置成功，返回 1 。  
如果哈希表中域 field 已经存在且旧值已被新值覆盖，返回 0 。  
redis> HSET website google “www.g.cn” \# 设置一个新域  
(integer) 1

redis> HSET website google “www.google.com” \# 覆盖一个旧域  
(integer) 0  
**12、HSETNX**  
HSETNXkey field value

将哈希表 key 中的域 field 的值设置为 value ，当且仅当域 field 不存在。

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

如果 key 不存在，一个新哈希表被创建并执行 HSETNX 命令。

可用版本：  
2.0.0+

返回值：  
设置成功，返回 1 。  
如果给定域已经存在且没有操作被执行，返回 0 。  
redis> HSETNX nosql key-value-store redis  
(integer) 1

redis> HSETNX nosql key-value-store redis \# 操作无效，域 key-value-store 已存在  
(integer) 0

**13、HVALS**  
HVALS key

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

可用版本：  
2.0.0+

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

redis> HMSET website google www.google.com yahoo www.yahoo.com  
OK

redis> HVALS website  
1) “www.google.com”  
2) “www.yahoo.com”

**空哈希表/不存在的key**

redis> EXISTS not\_exists  
(integer) 0

redis> HVALS not\_exists  
(empty list or set)

**14、HSCAN**

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

具体信息请参考 SCAN 命令。

Redis学习记录之命令Hash(十)

发表评论取消回复

还没有评论，来说两句吧...

相关阅读

相关 Redis之Hash命令

相关 Redis学习记录之Transaction(十八)

相关 Redis学习记录之命令Pub/Sub(十六)

相关 Redis学习记录之命令GEO(十五)

相关 Redis学习记录之命令HyperLogLog(十四)

相关 Redis学习记录之命令SortedSet(十三)

相关 Redis学习记录之命令Set(十二)

相关 Redis学习记录之命令List(十一)

相关 Redis学习记录之命令Hash(十)

相关 redis学习至hash命令