Redis命令參考手冊——Hash（哈希表）

Redis命令參考手冊——Hash（哈希表）

1、HSET

格式：hset key field value
將哈希表 key 中的域 field 的值設爲 value 。
如果 key 不存在，一個新的哈希表被創建並進行 HSET 操作。
如果域 field 已經存在於哈希表中，舊值將被覆蓋。
可用版本：

>=2.0.0

時間複雜度：
O(1)
返回值：
如果 field 是哈希表中的一個新建域，並且值設置成功，返回 1 。 如果哈希表中域 field 已經存在且舊值已被新值覆蓋，返回 0 。
示例代碼：

redis> HSET website google "www.g.cn" # 設置一個新域
(integer) 1
redis> HSET website google "www.google.com" # 覆蓋一箇舊域
(integer) 0

2、HSETNX

格式：hsetnx key field value
將哈希表 key 中的域 field 的值設置爲 value ，當且僅當域 field 不存在。
若域 field 已經存在，該操作無效。
如果 key 不存在，一個新哈希表被創建並執行 HSETNX 命令。
可用版本：

>=2.0.0

時間複雜度：
O(1)
返回值：
設置成功，返回 1 。 如果給定域已經存在且沒有操作被執行，返回 0 。
示例代碼：

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

3、HMSET

格式：hmset key field value [field value …]
同時將多個 field-value (域-值)對設置到哈希表 key 中。
此命令會覆蓋哈希表中已存在的域。
如果 key 不存在，一個空哈希表被創建並執行 HMSET 操作。
可用版本：

>=2.0.0

時間複雜度：
O(N)， N 爲 field-value 對的數量。
返回值：
如果命令執行成功，返回 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"

4、HGET

格式：hget key field
返回哈希表 key 中給定域 field 的值。
可用版本：

>=2.0.0

時間複雜度：
O(1)
返回值：
給定域的值。 當給定域不存在或是給定 key 不存在時，返回 nil 。
示例代碼：

# 域存在
redis> HSET site redis redis.com
(integer) 1
redis> HGET site redis
"redis.com"
# 域不存在
redis> HGET site mysql
(nil)

5、HMGET

格式：hmget key field [field …]
返回哈希表 key 中，一個或多個給定域的值。
如果給定的域不存在於哈希表，那麼返回一個 nil 值。
因爲不存在的 key 被當作一個空哈希表來處理，所以對一個不存在的 key 進行 HMGET操作將返回一個只帶有 nil 值的表。
可用版本：

>=2.0.0

時間複雜度：
O(N)， N 爲給定域的數量。
返回值：
一個包含多個給定域的關聯值的表，表值的排列順序和給定域參數的請求順序一樣。
示例代碼：

redis> HMSET pet dog "doudou" cat "nounou" # 一次設置多個域
OK
redis> HMGET pet dog cat fake_pet # 返回值的順序和傳入參數的順序一樣
1) "doudou"
2) "nounou"
3) (nil) # 不存在的域返回 nil 值

6、HGETALL

格式：hgetall key
返回哈希表 key 中，所有的域和值。
在返回值裏，緊跟每個域名(field name)之後是域的值(value)，所以返回值的長度是哈希表大小的兩倍。
可用版本：

>=2.0.0

時間複雜度：
O(N)， N 爲哈希表的大小。
返回值：
以列表形式返回哈希表的域和域的值。 若 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"

7、HDEL

格式：hdel key field [field …]
刪除哈希表 key 中的一個或多個指定域，不存在的域將被忽略。
注：在 Redis2.4 以下的版本里， HDEL 每次只能刪除單個域，如果你需要在一個原子時間內刪除多個域，請將命令包含在 MULTI / EXEC 塊內。
可用版本：

>=2.0.0

時間複雜度：
O(N)， N 爲要刪除的域的數量。
返回值：
被成功移除的域的數量，不包括被忽略的域。
示例代碼：

# 測試數據
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"

8、HLEN

格式：hlen key
返回哈希表 key 中域的數量。
時間複雜度：
O(1)
返回值：
哈希表中域的數量。 當 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、HEXISTS

格式：hexists key field
查看哈希表 key 中，給定域 field 是否存在。
可用版本：

>=2.0.0

時間複雜度：
O(1)
返回值：
如果哈希表含有給定域，返回 1 。 如果哈希表不含有給定域，或 key 不存在，返回 0 。
示例代碼：

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

10、HINCRBY

格式：hincrby key field increment
爲哈希表 key 中的域 field 的值加上增量 increment 。 增量也可以爲負數，相當於對給定域進行減法操作。 如果 key 不存在，一個新的哈希表被創建並執行 HINCRBY 命令。 如果域 field 不存在，那麼在執行命令前，域的值被初始化爲 0 。 對一個儲存字符串值的域 field 執行 HINCRBY 命令將造成一個錯誤。 本操作的值被限制在 64 位(bit)有符號數字表示之內。
可用版本：

>=2.0.0

時間複雜度：
O(1)
返回值：
執行 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"

11、HINCRBYFLOAT

格式：hincrbyfloat key field increment
爲哈希表 key 中的域 field 加上浮點數增量 increment 。
如果哈希表中沒有域 field ，那麼 HINCRBYFLOAT 會先將域 field 的值設爲 0 ，然後再執行加法操作。
如果鍵 key 不存在，那麼 HINCRBYFLOAT 會先創建一個哈希表，再創建域 field ，最後再執行加法操作。
當以下任意一個條件發生時，返回一個錯誤： 1.域 field 的值不是字符串類型(因爲 redis 中的數字和浮點數都以字符串的形式保存，所以它們都屬於字符串類型） 2.域 field 當前的值或給定的增量 increment 不能解釋(parse)爲雙精度浮點數(double precision floating point number)
HINCRBYFLOAT 命令的詳細功能和 INCRBYFLOAT 命令類似，請查看 INCRBYFLOAT 命令獲取更多相關信息。
可用版本：

>=2.6.0

時間複雜度：
O(1)
返回值：
執行加法操作之後 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"

12、HKEYS

格式：hkeys key
返回哈希表 key 中的所有域。
可用版本：

>=2.0.0

時間複雜度：
O(N)， N 爲哈希表的大小。
返回值：
一個包含哈希表中所有域的表。 當 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)

13、HVALS

格式：hvals key
返回哈希表 key 中所有域的值。
可用版本：

>=2.0.0

時間複雜度：
O(N)， N 爲哈希表的大小。
返回值：
一個包含哈希表中所有值的表。 當 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)