redis中的Hash

Hash
一个hash中有很多个域，每个域都是一个key-value对

设置指定域中的值

HSET key field value
将哈希表 key 中的域 field 的值设为 value 。
如果 key 不存在，一个新的哈希表被创建并进行 HSET 操作。
如果域 field 已经存在于哈希表中，旧值将被覆盖。

返回值：

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

local_redis:0>hset myhash 'my' 'hash'
"1"
local_redis:0>hget myhash 'my'
"hash"
local_redis:0>hset myhash 'my' 'myhash'
"0"
local_redis:0>hget myhash 'my'
"myhash"

返回指定域的值

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

返回值：

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

local_redis:0>hget myhash 'my'
"myhash"
local_redis:0>hget myhash 'm'
null
local_redis:0>hget ss 'my'
null

判断指定域是否存在

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

返回值：

如果哈希表含有给定域，返回 1 。
如果哈希表不含有给定域，或 key 不存在，返回 0 。

local_redis:0>hexists myhash 'my'
"1"

local_redis:0>hexists myhash ss
"0"

local_redis:0>hexists ss 'my'
"0"

删除域

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

返回值:

被成功移除的域的数量，不包括被忽略的域。

local_redis:0>hdel myhash 'my' 'ss'
"1"

返回所有域和他的值

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

返回值：

以列表形式返回哈希表的域和域的值。
若 key 不存在，返回空列表。

local_redis:0>hgetall myhash


local_redis:0>hset myhash 5 6
"1"

local_redis:0>hset myhash 6 7
"1"

local_redis:0>hset myhash 7 8
"1"

local_redis:0>hgetall myhash
 1)  "5"
 2)  "6"
 3)  "6"
 4)  "7"
 5)  "7"
 6)  "8"

对指定域添加增量

HINCRBY key field increment
为哈希表 key 中的域 field 的值加上增量 increment 。
增量也可以为负数，相当于对给定域进行减法操作。
如果 key 不存在，一个新的哈希表被创建并执行 HINCRBY 命令。
如果域 field 不存在，那么在执行命令前，域的值被初始化为 0 。、
对一个储存字符串值的域 field 执行 HINCRBY 命令将造成一个错误。
本操作的值被限制在 64 位(bit)有符号数字表示之内。

返回值：

执行 HINCRBY 命令之后，哈希表 key 中域 field 的值。

local_redis:0>hget myhash 5
"6"

local_redis:0>hincrby myhash 5 10
"16"

local_redis:0>hget myhash 5
"16"

local_redis:0>HEXISTS counter page_view 
"0"

local_redis:0>HINCRBY counter page_view 200
"200"

local_redis:0>HGET counter page_view
"200"

对指定域添加增量(浮点数增量)

HINCRBYFLOAT key field increment

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

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

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

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

域 field 的值不是字符串类型(因为 redis 中的数字和浮点数都以字符串的形式保存，所以它们都属于字符串类型）
域 field 当前的值或给定的增量 increment 不能解释(parse)为双精度浮点数(double precision floating point number)

返回值：

执行加法操作之后 field 域的值。

# 值和增量都是普通小数
local_redis:0>HSET mykey field 10.50
"1"

local_redis:0>HINCRBYFLOAT mykey field 0.1
"10.6"
# 值和增量都是指数符号
local_redis:0> HSET mykey field 5.0e3
"0"

local_redis:0>HINCRBYFLOAT mykey field 2.0e2
"5200"

# 对不存在的键执行 HINCRBYFLOAT
local_redis:0>EXISTS price
"0"

local_redis:0>HINCRBYFLOAT price milk -3.5
"-3.5"


# 对不存在的域进行 HINCRBYFLOAT
local_redis:0>HGETALL price
 1)  "milk"
 2)  "-3.5"
local_redis:0>HINCRBYFLOAT price coffee 4.5
"4.5"
local_redis:0>HGETALL price
 1)  "milk"
 2)  "-3.5"
 3)  "coffee"
 4)  "4.5"

返回所有的域

HKEYS key

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

返回值：

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

local_redis:0>HMSET website google www.google.com yahoo www.yahoo.com
"OK"
local_redis:0>HKEYS website
 1)  "google"
 2)  "yahoo"
local_redis:0>EXISTS fake_key
"0"
local_redis:0>HKEYS fake_key

返回Hash的域的个数（长度）

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

返回值：

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

local_redis:0>hlen website
"2"

设置多个域的值

HMSET key field value [field value …]

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

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

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

返回值：

如果命令执行成功，返回 OK 。
当 key 不是哈希表(hash)类型时，返回一个错误。

local_redis:0>HMSET website google www.google.com yahoo www.yahoo.com
"OK"
local_redis:0>hgetall website
 1)  "google"
 2)  "www.google.com"
 3)  "yahoo"
 4)  "www.yahoo.com"

返回多个域的值

HMGET key field [field …]

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

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

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

返回值：

一个包含多个给定域的关联值的表，表值的排列顺序和给定域参数的请求顺序一样。

local_redis:0>HMSET pet dog "doudou" cat "nounou" 
"OK"

local_redis:0>HMGET pet dog cat fake_pet
 1)  "doudou"
 2)  "nounou"
 3)  null   //不存在的域返回nil值

添加一个新的域和其值（当这个域不存在时才能进行）

HSETNX key field value

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

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

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

返回值：

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

local_redis:0>HSETNX nosql key-value-store redis
"1"
local_redis:0>hget nosql key-value-store
"redis"
local_redis:0>HSETNX nosql key-value-store redis
"0"

返回所有的域中的值

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

返回值：

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

local_redis:0>HMSET website google www.google.com yahoo www.yahoo.com
"OK"
local_redis:0>HVALS website
 1)  "www.google.com"
 2)  "www.yahoo.com"