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 plaincopyprint?
 
  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 plaincopyprint?
 
  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. }  


 

posted on 2015-05-20 16:59  babyblue  阅读(6144)  评论(0)  编辑  收藏  举报

Powered by: 博客园 Copyright © 2024 babyblue
Powered by .NET 9.0 on Kubernetes