redis 文檔： https://redis.readthedocs.io/en/2.4/index.html
keys *
type key
----------------------------------------------------------------------------------------
哈希表(Hash)
HSET
- HSET key field value
將哈希表key中的域field的值設為value。
如果key不存在，一個新的哈希表被創建並進行HSET操作。
如果域field已經存在於哈希表中，舊值將被覆蓋。
- 時間復雜度：
- O(1)
- 返回值：
-
如果 field是哈希表中的一個新建域，並且值設置成功，返回 1。如果哈希表中域 field已經存在且舊值已被新值覆蓋，返回 0。
redis> HSET website google "www.g.cn" # 一個新域
(integer) 1
redis> HSET website google "www.google.com" # 覆蓋一個舊域
(integer) 0
HSETNX
- HSETNX key field value
將哈希表key中的域field的值設置為value，當且僅當域field不存在。
若域field已經存在，該操作無效。
如果key不存在，一個新哈希表被創建並執行HSETNX命令。
- 時間復雜度：
- 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
HMSET
- HMSET key field value [field value ...]
同時將多個field - value(域-值)對設置到哈希表key中。
此命令會覆蓋哈希表中已存在的域。
如果key不存在，一個空哈希表被創建並執行HMSET操作。
- 時間復雜度：
- O(N)， N為 field - value對的數量。
- 返回值：
-
如果命令執行成功，返回 OK。當 key不是哈希表(hash)類型時，返回一個錯誤。
# 情況1： 哈希表
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"
# 情況2：類型錯誤時
redis> SET G 10 # 出錯情況
OK
redis> HMSET G name huangz age 20
(error) ERR Operation against a key holding the wrong kind of value
HGET
- HGET key field
返回哈希表key中給定域field的值。
- 時間復雜度：
- O(1)
- 返回值：
-
給定域的值。當給定域不存在或是給定 key不存在時，返回 nil。
redis> HSET huangz blog huangz.iteye.com
(integer) 1
redis> HGET huangz blog
"huangz.iteye.com"
HMGET
- HMGET key field [field ...]
返回哈希表key中，一個或多個給定域的值。
如果給定的域不存在於哈希表，那么返回一個nil值。
因為不存在的key被當作一個空哈希表來處理，所以對一個不存在的key進行HMGET操作將返回一個只帶有nil值的表。
- 時間復雜度：
- 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值
HGETALL
- HGETALL key
返回哈希表key中，所有的域和值。
在返回值里，緊跟每個域名(field name)之后是域的值(value)，所以返回值的長度是哈希表大小的兩倍。
- 時間復雜度：
- O(N)， N為哈希表的大小。
- 返回值：
- 以列表形式返回哈希表的域和域的值。 若 key不存在，返回空列表。
redis> HSET hash_name jack "Jack Sparrow"
(integer) 1
redis> HSET hash_name gump "Forrest Gump"
(integer) 1
redis> HGETALL hash_name
1) "jack" # 域
2) "Jack Sparrow" # 值
3) "gump"
4) "Forrest Gump"
HDEL
- HDEL key field [field ...]
刪除哈希表key中的一個或多個指定域，不存在的域將被忽略。
- 時間復雜度:
- 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"
HLEN
- HLEN key
返回哈希表key中域的數量。
- 時間復雜度：
- O(1)
- 返回值：
-
哈希表中域的數量。當 key不存在時，返回 0。
redis> HSET hash_name jack "Jack Sparrow"
(integer) 1
redis> HSET hash_name gump "Forrest Gump"
(integer) 1
redis> HLEN hash_name
(integer) 2
HEXISTS
- HEXISTS key field
查看哈希表key中，給定域field是否存在。
- 時間復雜度：
- 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
HINCRBY
- HINCRBY key field increment
為哈希表key中的域field的值加上增量increment。
增量也可以為負數，相當於對給定域進行減法操作。
如果key不存在，一個新的哈希表被創建並執行HINCRBY命令。
如果域field不存在，那么在執行命令前，域的值被初始化為0。
對一個儲存字符串值的域field執行HINCRBY命令將造成一個錯誤。
本操作的值限制在64位(bit)有符號數字表示之內。
- 時間復雜度：
- O(1)
- 返回值：
- 執行 HINCRBY命令之后，哈希表 key中域 field的值。
# 情況1：increment為正數
redis> HEXISTS counter page_view # 對空域進行設置
(integer) 0
redis> HINCRBY counter page_view 200
(integer) 200
redis> HGET counter page_view
"200"
# 情況2：increment為負數
redis> HGET counter page_view
"200"
redis> HINCRBY counter page_view -50
(integer) 150
redis> HGET counter page_view
"150"
# 情況3：嘗試對字符串值的域執行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"
HKEYS
- HKEYS key
返回哈希表key中的所有域。
- 時間復雜度：
- O(N)， N為哈希表的大小。
- 返回值：
-
一個包含哈希表中所有域的表。當 key不存在時，返回一個空表。
# 情況1：哈希表非空
redis> HMSET website google www.google.com yahoo www.yahoo.com
OK
redis> HKEYS website
1) "google"
2) "yahoo"
# 情況2：空哈希表/key不存在
redis> EXISTS fake_key
(integer) 0
redis> HKEYS fake_key
(empty list or set)
HVALS
- HVALS key
返回哈希表key中的所有值。
- 時間復雜度：
- O(N)， N為哈希表的大小。
- 返回值：
-
一個包含哈希表中所有值的表。當 key不存在時，返回一個空表。
# 情況1：非空哈希表
redis> HMSET website google www.google.com yahoo www.yahoo.com
OK
redis> HVALS website
1) "www.google.com"
2) "www.yahoo.com"
# 情況2：空哈希表/不存在的key
redis> EXISTS not_exists
(integer) 0
redis> HVALS not_exists
(empty list or set)