Redis基础数据类型——散列类型

散列类型

Redis本身是key-value结构，是一种字典类型。而散列类型，也是一种字典类型，类似Java的Map数据结构。其存储时有一个key，对应唯一的数据条目，Redis的散列类型值必须是字符串类型，不能够在散列类型中再嵌套其他类型。一个散列类型可以最多容纳2^32-1个元素。

散列类型一般用于存储数据详情，如某一用户的数据信息，按照存储空间+用户ID作为key，将用户数据作为值存储到Redis。

HSET users user:1 userObject

按此结构存储时，可以将用户的信息存储到key为users的散列数据类型中，每个用户ID作为用户的主键，一方面可以节省Redis的key，另一方面也便于维护。但是Redis的散列数据类型，过期时间是一个统一设置方式，没办法对每一项独立设置过期时间。

命令

添加数据

HSET key fieldKey value
HMSET key fieldKey value [fieldKey value ...]

HSET指令用于将字段值（fieldKey-value）添加到键为key的散列数据中。当fieldKey不存在时，返回1，当fieldkey存储在，只更新value，返回0。因此使用HSET创建数据时，不需要判断fieldKey是否存在。HMSET指令同HSET指令一样，都适用于创建数据，只不过HMSET一次可以创建多个数据，成功时返回ok；不区分字段是否存在，如果字段不存在创建，字段存在时，也是更新。

HSET users user:1 ray
# (integer) 1
HSET users user:1 "ray l"
# (integer) 0
HGET users user:1
# "ray l"
HMSET users user:1 ray user:2 hh
# OK
HMSET users user:1 ray
# OK

获取数据

HGET key fieldKey
HMGET key fieldKey [fieldKey ...]
MGETALL key

HGET命令可以获取一个字段的值，当需要获取多个字段值时，可以使用HMGET，其分别对应HSET、HMSET。

HGET users user:1
# "ray"
HMGET users user:1 user:2
# "ray"
# "hh"

当不清楚散列数据中包含那些字段时，可以通过HGETALL指令，该命令将会一次性将所有的字段值都读取出来，并按字段，值，字段，值...的顺序列出来。

HGETALL users
# "user:1"
# "ray"
# "user:2"
# "hh"

判断字段是否存在

HEXISTS key fieldKey

HEXISTS指令用于校验fieldKey字段是否存在，当字段存在时，返回1，当字段不存在，或key不存在时，返回0。

HEXISTS users user:1
# (integer) 1
HEXISTS user user   # 键user不存在
# (integer) 0
HEXISTS users user:3    # 字段不存在
# (integer) 0

字段不存在时创建

HSETNX key fieldKey value

HSETNX指令同SETNX指令类似，都表示不存在时创建。HSETNX用于判断字段是否存在，不存在时创建，存在时，不改变任何事情。当创建时，返回1，当字段不存在时，不创建返回0。

HSETNX users user:1 "ray lll"
# (integer) 0
HSETNX users user:3 "xx"
# (integer) 1

字段值增加指定的数值

HINCRBY key fieldKey increment
HINCRBYFLOAT key fieldKey incrementFloat

HINCRBY指令与INCRBY指令类似，该指令用于对字段fieldKey增加指定的increment整数。当字段不存在时，将会创建该字段，默认为0，并执行增加increment命令。返回值为增加increment后的整数值。

HINCRBYFLOAT指令与HINCRBY指令基本类似，只不过该指令用于增加一个浮点数。

HINCRBY zan user:1 12   # 字段不存在，key也不存在
# (integer) 12
HINCRBY zan user:1 1
# (integer) 1
HINCRBY zan user:2 12.5
# "12.5"

删除字段

HDEL key fieldKey [fieldKey ...]

HDEL指令可以删除一个多个字段信息。返回值为成功删除的字段数量。

HDEL users user:1 user:2 user:5
# (integer) 2

获取字段名列表

HKEYS key

HKEYS指令用于返回key中的所有字段列表。

HKEYS users
# "user:3"

获取字段值列表

HVALS key

HVALS指令与HKEYS指令对应，该指令用于返回所有字段值得列表。

HVALS users
# "xx"

查询字段名数量

HLEN key

HLEN指令用于返回指定KEY的字段名数量，即key散列表的总数量。

HLEN users
# (integer) 1