Redis 哈希(Hash)

发布时间 2023-03-27 11:54:10作者: 红尘过客2022

Redis 哈希(Hash)

Redis hash 是一个 string 类型的 field(字段) 和 value(值) 的映射表,hash 特别适合用于存储对象。

Redis 中每个 hash 可以存储 232 - 1 键值对(40多亿)。

实例

> hset host name dgg1023 ip 192.168.0.0.1
2
> hgetall host
name
dgg1023
ip
192.168.0.0.1

命令

Hdel

Redis Hdel 命令用于删除哈希表 key 中的一个或多个指定字段,不存在的字段将被忽略。

语法

> HDEL KEY_NAME FIELD1.. FIELDN 

返回值

被成功删除字段的数量,不包括被忽略的字段。

实例

> hset host desc myHost
1
> hdel host field1
0
> hdel host desc
1

Hexists

Redis Hexists 命令用于查看哈希表的指定字段是否存在。

语法

> HEXISTS KEY_NAME FIELD_NAME 

返回值

如果哈希表含有给定字段,返回 1 。 如果哈希表不含有给定字段,或 key 不存在,返回 0 。

实例

> hexists host name
1
> hexists host test
0

Hget

Redis Hget 命令用于返回哈希表中指定字段的值。

语法

> HGET KEY_NAME FIELD_NAME 

返回值

返回给定字段的值。如果给定的字段或 key 不存在时,返回 nil 。

实例

> hget host name
dgg1023
> hget host status
null

Hgetall

Redis Hgetall 命令用于返回哈希表中,所有的字段和值。

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

语法

>  HGETALL KEY_NAME 

返回值

以列表形式返回哈希表的字段及字段值。 若 key 不存在,返回空列表。

实例

> hgetall host
name
dgg1023
ip
192.168.0.0.1

Hincrby

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

增量也可以为负数,相当于对指定字段进行减法操作。

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

如果指定的字段不存在,那么在执行命令前,字段的值被初始化为 0 。

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

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

语法

> HINCRBY KEY_NAME FIELD_NAME INCR_BY_NUMBER 

返回值

执行 HINCRBY 命令之后,哈希表中字段的值。

实例

> hincrby host job_count 1
1
> hincrby host job_count -1
0
> hget host job_count
0

Hincrbyfloat

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

如果指定的字段不存在,那么在执行命令前,字段的值被初始化为 0 。

语法

> HINCRBYFLOAT key field increment

返回值

执行 Hincrbyfloat 命令之后,哈希表中字段的值。

实例

> hincrbyfloat host mem_useage 0.2
0.2
> hincrbyfloat host mem_useage 0.2
0.4
> hincrbyfloat host mem_useage 0.3
0.7
> hincrbyfloat host mem_useage 0.3
1

Hkeys

Redis Hkeys 命令用于获取哈希表中的所有域(field)。

语法

>HKEYS key 

返回值

包含哈希表中所有域(field)列表。 当 key 不存在时,返回一个空列表。

实例

> hkeys host
name
ip
job_count
mem_useage

Hlen

Redis Hlen 命令用于获取哈希表中字段的数量。

语法

> HLEN KEY_NAME 

返回值

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

实例

> hlen host
4

Hmget

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

如果指定的字段不存在于哈希表,那么返回一个 nil 值。

语法

> HMGET KEY_NAME FIELD1...FIELDN 

返回值

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

实例

> hmget host name ip
dgg1023
192.168.0.0.1

Hmset

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

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

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

语法

> HMSET KEY_NAME FIELD1 VALUE1 ...FIELDN VALUEN 

返回值

如果命令执行成功,返回 OK 。

实例

> hmset host uuid absdaf12fdas1515 status 1
OK

Hset

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

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

如果字段已经存在于哈希表中,旧值将被覆盖。

语法

> HSET KEY_NAME FIELD VALUE

返回值

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

实例

> hset host project com.ali.mysql
1

Hsetnx

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

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

如果字段已经存在于哈希表中,操作无效。

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

语法

> HSETNX KEY_NAME FIELD VALUE

返回值

设置成功,返回 1 。 如果给定字段已经存在且没有操作被执行,返回 0 。

实例

> hsetnx host project com.ali.redis
0

Hvals

Redis Hvals 命令返回哈希表所有的值。

语法

> HVALS key

返回值

一个包含哈希表中所有值的列表。 当 key 不存在时,返回一个空表。

实例

> hvals host
dgg1023
192.168.0.0.1
0
1
absdaf12fdas1515
1
com.ali.mysql

思考:

在什么场景下适用hash存储数据