Redis hash 是一個string類型的field和value的映射表，hash特別適合用於存儲對象。

Redis 中每個 hash 可以存儲 \(2^{32} - 1\) 鍵值對（40多億）。

實例

127.0.0.1:6379>  HMSET tutor name "redis tutorial" description "redis basic commands for caching" likes 20 visitors 23000
OK
127.0.0.1:6379>  HGETALL tutor
1) "name"
2) "redis tutorial"
3) "description"
4) "redis basic commands for caching"
5) "likes"
6) "20"
7) "visitors"
8) "23000"
 

Redis hash 命令

Hset & Hget

Redis Hset 命令用於為哈希表中的字段賦值 。如果哈希表不存在，一個新的哈希表被創建並進行 HSET 操作。如果字段已經存在於哈希表中，舊值將被覆蓋。

redis 127.0.0.1:6379> HSET myhash field1 "foo"
OK
redis 127.0.0.1:6379> HGET myhash field1
"foo"

redis 127.0.0.1:6379> HSET website google "www.g.cn"       # 設置一個新域
(integer) 1

redis 127.0.0.1:6379>HSET website google "www.google.com"  # 覆蓋一個舊域
(integer) 0
 

Redis Hget 命令用於返回哈希表中指定字段的值。返回給定字段的值。如果給定的字段或 key 不存在時，返回 nil 。

# 字段存在
redis> HSET site redis redis.com
(integer) 1
redis> HGET site redis
"redis.com"

# 字段不存在
redis> HGET site mysql
(nil)

Hdel & Hexists

Redis Hdel 命令用於刪除哈希表 key 中的一個或多個指定字段，不存在的字段將被忽略。

redis 127.0.0.1:6379> HSET myhash field1 "foo"
(integer) 1
redis 127.0.0.1:6379> HDEL myhash field1
(integer) 1
redis 127.0.0.1:6379> HDEL myhash field2
(integer) 0
 

Redis Hexists 命令用於查看哈希表的指定字段是否存在。如果哈希表含有給定字段，返回 1 。 如果哈希表不含有給定字段，或 key 不存在，返回 0 。

redis 127.0.0.1:6379> HSET myhash field1 "foo"
(integer) 1
redis 127.0.0.1:6379> HEXISTS myhash field1
(integer) 1
redis 127.0.0.1:6379> HEXISTS myhash field2
(integer) 0

Hsetnx

Redis Hsetnx 命令用於為哈希表中不存在的的字段賦值 。

如果哈希表不存在，一個新的哈希表被創建並進行 HSET 操作。

如果字段已經存在於哈希表中，操作無效。

如果 key 不存在，一個新哈希表被創建並執行 HSETNX 命令。

redis 127.0.0.1:6379> HSETNX myhash field1 "foo"
(integer) 1
redis 127.0.0.1:6379> HSETNX myhash field1 "bar"
(integer) 0
redis 127.0.0.1:6379> HGET myhash field1
"foo"

redis 127.0.0.1:6379> HSETNX nosql key-value-store redis
(integer) 1

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

Hkeys & Hvals & Hgetall

Redis Hkeys 命令用於獲取哈希表中的所有域（field）。當 key 不存在時，返回一個空列表。

redis 127.0.0.1:6379> HSET myhash field1 "foo"
(integer) 1
redis 127.0.0.1:6379> HSET myhash field2 "bar"
(integer) 1
redis 127.0.0.1:6379> HKEYS myhash
1) "field1"
2) "field2"

Redis Hvals 命令返回哈希表所有域(field)的值。當 key 不存在時，返回一個空表。

redis 127.0.0.1:6379> HSET myhash field1 "foo"
(integer) 1
redis 127.0.0.1:6379> HSET myhash field2 "bar"
(integer) 1
redis 127.0.0.1:6379> HVALS myhash
1) "foo"
2) "bar"

# 空哈希表/不存在的key

redis 127.0.0.1:6379> EXISTS not_exists
(integer) 0

redis 127.0.0.1:6379> HVALS not_exists
(empty list or set)

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

在返回值裏，緊跟每個字段名(field name)之後是字段的值(value)，所以返回值的長度是哈希表大小的兩倍。

redis> HSET myhash field1 "Hello"
(integer) 1
redis> HSET myhash field2 "World"
(integer) 1
redis> HGETALL myhash
1) "field1"
2) "Hello"
3) "field2"
4) "World"
redis> 

Hlen

Redis Hlen 命令用於獲取哈希表中字段的數量。當 key 不存在時，返回 0 。

redis 127.0.0.1:6379> HSET myhash field1 "foo"
(integer) 1
redis 127.0.0.1:6379> HSET myhash field2 "bar"
(integer) 1
redis 127.0.0.1:6379> HLEN myhash
(integer) 2

Hmset & Hmget

Redis Hmset 命令用於同時將多個 field-value (字段-值)對設置到哈希表中。

此命令會覆蓋哈希表中已存在的字段。

如果哈希表不存在，會創建一個空哈希表，並執行 HMSET 操作。

redis 127.0.0.1:6379> HMSET myhash field1 "Hello" field2 "World"
OK
redis 127.0.0.1:6379> HGET myhash field1
"Hello"
redis 127.0.0.1:6379> HGET myhash field2
"World"

Redis Hmget 命令用於返回哈希表中，一個或多個給定字段的值。

如果指定的字段不存在於哈希表，那麽返回一個 nil 值。表值的排列順序和指定字段的請求順序一樣。

redis 127.0.0.1:6379> HSET myhash field1 "foo"
(integer) 1
redis 127.0.0.1:6379> HSET myhash field2 "bar"
(integer) 1
redis 127.0.0.1:6379> HMGET myhash field1 field2 nofield
1) "foo"
2) "bar"
3) (nil)

Hincrby

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

增量也可以為負數，相當於對指定字段進行減法操作。

如果哈希表的 key 不存在，一個新的哈希表被創建並執行 HINCRBY 命令。

如果指定的字段不存在，那麽在執行命令前，字段的值被初始化為 0 。

對一個儲存字符串值的字段執行 HINCRBY 命令將造成一個錯誤。

本操作的值被限制在 64 位(bit)有符號數字表示之內。

redis> HSET myhash field 5
(integer) 1
redis> HINCRBY myhash field 1
(integer) 6
redis> HINCRBY myhash field -1
(integer) 5
redis> HINCRBY myhash field -10
(integer) -5
redis> 

類似的還有： Redis Hincrbyfloat 命令用於為哈希表中的字段值加上指定浮點數增量值。如果指定的字段不存在，那麽在執行命令前，字段的值被初始化為 0 。

Redis哈希(Hash)