redis的hash表介紹

redis的hash表介紹

 

• 哈希表(Hash)
  • HSET
  • HSETNX
  • HMSET
  • HGET
  • HMGET
  • HGETALL
  • HDEL
  • HLEN
  • HEXISTS
  • HINCRBY
  • HKEYS
  • HVALS

 

哈希表(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爲要刪除的域的數量。

返回值:

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

註解

在Redis2.4如下的版本里，HDEL每次只能刪除單個域，若是你須要在一個原子時間內刪除多個域，請將命令包含在MULTI/ EXEC塊內。

# 測試數據

 

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)