redis:hash数据类型与操作

    Redis hash是一个string类型的field和value的映射表.一个key可对应多个field，一个field对应一个value。将一个对象存储为hash类型，较于每个字段都存储成string类型更能节省内存。新建一个hash对象时开始是用zipmap(又称为small hash)来存储的。这个zipmap其实并不是hash table，但是zipmap相比正常的hash实现可以节省不少hash本身需要的一些元数据存储开销。尽管zipmap的添加，删除，查找都是O(n)，但是由于一般对象的field数量都不太多。所以使用zipmap也是很快的,也就是说添加删除平均还是O(1)。如果field或者value的大小超出一定限制后，redis会在内部自动将zipmap替换成正常的hash实现.。这个限制在redis.conf中配置如下：

[plain]  view plain  copy

 print ?

1. 421 # Hashes are encoded in a special way (much more memory efficient) when they  
2. 422 # have at max a given numer of elements, and the biggest element does not  
3. 423 # exceed a given threshold. You can configure this limits with the following  
4. 424 # configuration directives.  
5. 425 hash-max-zipmap-entries 512  
6. 426 hash-max-zipmap-value 64  

• 操作

1. hset

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

2. hget

HGET key field

返回哈希表key中指定的field的值。

3. hsetnx

HSETNX key field value
将哈希表 key中的域 field的值设置为 value，当且仅当域 field不存在。若域 field已经存在，该操作无效。如果 key不存在，一个新哈希表被创建并执行hsetnx命令。

4. hmset

HMSET key field value [field value ...]

同时将多个field - value(域-值)对设置到哈希表key中。此命令会覆盖哈希表中已存在的域。如果key不存在，一个空哈希表被创建并执行hmset操作。

5. hmget

HMGET key field [field ...]

返回哈希表key中，一个或多个给定域的值。如果给定的域不存在于哈希表，那么返回一个nil值。因为不存在的key被当作一个空哈希表来处理，所以对一个不存在的key进行hmget操作将返回一个只带有nil值的表。

6. hgetall

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

7. hdel

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

8. hlen

HLEN key

返回哈希表key对应的field的数量。

9. hexists

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

10. hkeys

HKEYS key

获得哈希表中key对应的所有field。

11. hvals

HVALS key

获得哈希表中key对应的所有values。

12. hincrby

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

更多详细信息请参照：http://redis.readthedocs.org/en/2.4/hash.html

下面是利用redis c++客户端编写的测试程序：

[cpp]  view plain  copy

 print ?

1. #include "redisclient.h"  
2.   
3. #include "tests/functions.h"  
4.   
5. #include <iostream>  
6.   
7. #include <boost/date_time.hpp>  
8.   
9. #define OUT(x) std::cout<<#x<<" = "<<x<<std::endl;  
10.   
11. boost::shared_ptr<redis::client> init_non_cluster_client();  
12. void test_hash(redis::client & c);  
13.   
14. int main(int argv, char* argc[])   
15. {  
16.     boost::shared_ptr<redis::client> shared_c;  
17.   
18.     shared_c = init_non_cluster_client();  
19.   
20.     redis::client& c = *shared_c;  
21.   
22.     test_hash(c);  
23.   
24.     return 0;  
25. }  
26. void test_hash(redis::client & c)  
27. {  
28.     test("test hash type");  
29.   
30.     test("hset & hget & hsetnx");  
31.     {  
32.         // hset: key, field, value  
33.         OUT(c.hset("favorites", "taobao", "www.taobao.com"));  
34.         OUT(c.hset("favorites", "taobao", "www.taobao.com#"));  
35.         OUT(c.hget("favorites", "taobao"));  
36.         OUT(c.hsetnx("favorites", "taobao", "www.taobao.com"));  
37.         OUT(c.hget("favorites", "taobao"));  
38.     }  
39.   
40.     test("hmset & hmget & hgetall & hdel & hexists");  
41.     {  
42.         redis::client::string_vector fields, values, getvalues;  
43.         fields.push_back("tmall");  
44.         fields.push_back("alibaba");  
45.         values.push_back("www.tmall.com");  
46.         values.push_back("www.1688.com");  
47.         c.hmset("favorites", fields, values);  
48.         // 类型错误，报错  
49.         c.set("string_key", "string_value");  
50.         //c.hmset("string_key", fields, values);  
51.         fields.push_back("etao");  
52.         c.hmget("favorites", fields, getvalues);  
53.         OUT(getvalues.size());  
54.         for(int i=0; i<getvalues.size(); ++i) {  
55.             OUT(getvalues[i]);  
56.         }  
57.   
58.         redis::client::string_pair_vector pairs;  
59.         c.hgetall("favorites", pairs);  
60.         OUT(pairs.size());  
61.         for(int i=0; i<pairs.size(); ++i) {  
62.             OUT(pairs[i].first);  
63.             OUT(pairs[i].second);  
64.         }  
65.   
66.         OUT(c.hset("favorites", "etao", "www.etao.com"));  
67.         OUT(c.hlen("favorites"));  
68.         pairs.clear();  
69.         c.hdel("favorites", "etao");  
70.         c.hdel("favorites", "koubei");  
71.         c.hgetall("favorites", pairs);  
72.         OUT(pairs.size());  
73.         for(int i=0; i<pairs.size(); ++i) {  
74.             OUT(pairs[i].first);  
75.             OUT(pairs[i].second);  
76.         }  
77.   
78.         OUT(c.hexists("favorites", "taobao"));  
79.         OUT(c.hexists("favorites", "koubei"));  
80.     }  
81.   
82.     test("hincrby & hkeys & hvals");  
83.     {  
84.         OUT(c.hset("lists", "age", "20"));  
85.         OUT(c.hincrby("lists", "age", 5));  
86.         redis::client::string_vector keys;  
87.         c.hkeys("lists", keys);  
88.         for(size_t i=0; i<keys.size(); ++i) {  
89.             OUT(keys[i]);  
90.         }  
91.         redis::client::string_vector vals;  
92.         c.hvals("lists", vals);  
93.         for(size_t i=0; i<keys.size(); ++i) {  
94.             OUT(vals[i]);  
95.         }  
96.     }  
97. }