redis——哈希（hash）

Redis hash 是一个string类型的field和value的映射表，hash特别适合用于存储对象。

Redis 中每一个 hash 能够存储 2^32 - 1 键值对（40多亿）。

 

hash命令

一、HDEL key field1 [field2....]

删除一个或多个哈希表字段，不存在的字段将被忽略。返回被成功删除字段的数量，不包括被忽略的字段。

redis 127.0.0.1:6379> HSET myhash field1 "foo"
(integer) 1
redis 127.0.0.1:6379> HDEL myhash field1
(integer) 1
redis 127.0.0.1:6379> HDEL myhash field2
(integer) 0

 

二、HEXISTS key field

查看哈希表key中，指定的字段是否存在。若是哈希表含有给定字段，返回1。若是哈希表不含有给定字段，或key不存在，返回0。

redis 127.0.0.1:6379> HSET myhash field1 "foo"
(integer) 1
redis 127.0.0.1:6379> HEXISTS myhash field1
(integer) 1
redis 127.0.0.1:6379> HEXISTS myhash field2
(integer) 0

 

三、HGET key field

返回哈希表中指定字段的值。若是给定的字段或key不存在时，返回nil。

# 字段存在

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

redis> HGET site redis
"redis.com"


# 字段不存在

redis> HGET site mysql
(nil)

 

四、HGETALL key 

用于返回哈希表中，全部的字段和值。在返回值里，紧跟每一个字段名（field nam）以后是字段的值（value）,因此返回值的长度是哈希表大小的两倍。以列表形式返回哈希表的字段及字段值。若key不存在，返回空列表。

redis> HSET myhash field1 "Hello"
(integer) 1
redis> HSET myhash field2 "World"
(integer) 1
redis> HGETALL myhash
1) "field1"
2) "Hello"
3) "field2"
4) "World"
redis>

 

五、HINCRBY key field increment

Redis Hincrby 命令用于为哈希表中的字段值加上指定增量值。

增量也能够为负数，至关于对指定字段进行减法操做。

若是哈希表的 key 不存在，一个新的哈希表被建立并执行 HINCRBY 命令。

若是指定的字段不存在，那么在执行命令前，字段的值被初始化为 0 。

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

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

执行HINCRBY命令以后，哈希表中字段的值。

redis> HSET myhash field 5
(integer) 1
redis> HINCRBY myhash field 1
(integer) 6
redis> HINCRBY myhash field -1
(integer) 5
redis> HINCRBY myhash field -10
(integer) -5
redis>

 

六、HINCRBYFLOAT key field increment

Redis Hincrbyfloat 命令用于为哈希表中的字段值加上指定浮点数增量值。

若是指定的字段不存在，那么在执行命令前，字段的值被初始化为 0 。

返回执行hincrbyfloat命令以后，哈希表中字段的值。

redis> HSET mykey field 10.50
(integer) 1
redis> HINCRBYFLOAT mykey field 0.1
"10.60000000000000001"
redis> HINCRBYFLOAT mykey field -5
"5.59999999999999964"
redis> HSET mykey field 5.0e3
(integer) 0
redis> HINCRBYFLOAT mykey field 2.0e2
"5200"
redis>

 

七、HKEYS key

用于获取哈希表中的全部域（field）.

返回包含哈希表中全部域列表，当key不存在时，返回一个空列表。

redis 127.0.0.1:6379> HSET myhash field1 "foo"
(integer) 1
redis 127.0.0.1:6379> HSET myhash field2 "bar"
(integer) 1
redis 127.0.0.1:6379> HKEYS myhash
1) "field1"
2) "field2"

 

八、HLEN key

获取哈希表中字段的数量。

返回哈希表中字段的数量，当key不存在时，返回0。

redis 127.0.0.1:6379> HSET myhash field1 "foo"
(integer) 1
redis 127.0.0.1:6379> HSET myhash field2 "bar"
(integer) 1
redis 127.0.0.1:6379> HLEN myhash
(integer) 2

 

九、HMGET  key field1 ..... fieldN

Redis Hmget 命令用于返回哈希表中，一个或多个给定字段的值。

若是指定的字段不存在于哈希表，那么返回一个 nil 值。

返回一个包含多个给定字段关联值的表，表值的排列顺序和指定字段的请求顺序同样。

redis 127.0.0.1:6379> HSET myhash field1 "foo"
(integer) 1
redis 127.0.0.1:6379> HSET myhash field2 "bar"
(integer) 1
redis 127.0.0.1:6379> HMGET myhash field1 field2 nofield
1) "foo"
2) "bar"
3) (nil)

 

十、HMSET key field1 value1 .... fieldN valueN

Redis Hmset 命令用于同时将多个 field-value (字段-值)对设置到哈希表中。

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

若是哈希表不存在，会建立一个空哈希表，并执行 HMSET 操做。

返回值：若是命令执行成功，返回OK。

redis 127.0.0.1:6379> HMSET myhash field1 "Hello" field2 "World"
OK
redis 127.0.0.1:6379> HGET myhash field1
"Hello"
redis 127.0.0.1:6379> HGET myhash field2
"World"

 

十一、HSET key field value

Redis Hset 命令用于为哈希表中的字段赋值 。

若是哈希表不存在，一个新的哈希表被建立并进行 HSET 操做。

若是字段已经存在于哈希表中，旧值将被覆盖。

若是字段是哈希表中的一个新建字段，而且值设置成功，返回 1 。 若是哈希表中域字段已经存在且旧值已被新值覆盖，返回 0 

redis 127.0.0.1:6379> HSET myhash field1 "foo"
OK
redis 127.0.0.1:6379> HGET myhash field1
"foo"

redis 127.0.0.1:6379> HSET website google "www.g.cn"       # 设置一个新域
(integer) 1

redis 127.0.0.1:6379>HSET website google "www.google.com" # 覆盖一个旧域
(integer) 0

 

十二、HSETNX key  field value

Redis Hsetnx 命令用于为哈希表中不存在的的字段赋值 。

若是哈希表不存在，一个新的哈希表被建立并进行 HSET 操做。

若是字段已经存在于哈希表中，操做无效。

若是 key 不存在，一个新哈希表被建立并执行 HSETNX 命令。

设置成功，返回 1 。 若是给定字段已经存在且没有操做被执行，返回 0 。

redis 127.0.0.1:6379> HSETNX myhash field1 "foo"
(integer) 1
redis 127.0.0.1:6379> HSETNX myhash field1 "bar"
(integer) 0
redis 127.0.0.1:6379> HGET myhash field1
"foo"

redis 127.0.0.1:6379> HSETNX nosql key-value-store redis
(integer) 1

redis 127.0.0.1:6379> HSETNX nosql key-value-store redis       # 操做无效， key-value-store 已存在
(integer) 0

 

1三、HVALS key field value

Redis Hvals 命令返回哈希表全部域(field)的值。

一个包含哈希表中全部域(field)值的列表。 当 key 不存在时，返回一个空表。

redis 127.0.0.1:6379> HSET myhash field1 "foo"
(integer) 1
redis 127.0.0.1:6379> HSET myhash field2 "bar"
(integer) 1
redis 127.0.0.1:6379> HVALS myhash
1) "foo"
2) "bar"

# 空哈希表/不存在的key

redis 127.0.0.1:6379> EXISTS not_exists
(integer) 0

redis 127.0.0.1:6379> HVALS not_exists
(empty list or set)

 

1四、HSCAN key cursor [MATCH pattern] [COUNT count]

迭代哈希表中的键值对。