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中配置如下：

 

421 # Hashes are encoded in a special way (much more memory efficient) when they
422 # have at max a given numer of elements, and the biggest element does not
423 # exceed a given threshold. You can configure this limits with the following
424 # configuration directives.
425 hash-max-zipmap-entries 512
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++客戶端編寫的測試程序：

 

#include "redisclient.h"

#include "tests/functions.h"

#include <iostream>

#include <boost/date_time.hpp>

#define OUT(x) std::cout<<#x<<" = "<<x<<std::endl;

boost::shared_ptr<redis::client> init_non_cluster_client();
void test_hash(redis::client & c);

int main(int argv, char* argc[])
{
    boost::shared_ptr<redis::client> shared_c;

    shared_c = init_non_cluster_client();

    redis::client& c = *shared_c;

    test_hash(c);

    return 0;
}
void test_hash(redis::client & c)
{
    test("test hash type");

    test("hset & hget & hsetnx");
    {
        // hset: key, field, value
        OUT(c.hset("favorites", "taobao", "www.taobao.com"));
        OUT(c.hset("favorites", "taobao", "www.taobao.com#"));
        OUT(c.hget("favorites", "taobao"));
        OUT(c.hsetnx("favorites", "taobao", "www.taobao.com"));
        OUT(c.hget("favorites", "taobao"));
    }

    test("hmset & hmget & hgetall & hdel & hexists");
    {
        redis::client::string_vector fields, values, getvalues;
        fields.push_back("tmall");
        fields.push_back("alibaba");
        values.push_back("www.tmall.com");
        values.push_back("www.1688.com");
        c.hmset("favorites", fields, values);
        // 類型錯誤，報錯
        c.set("string_key", "string_value");
        //c.hmset("string_key", fields, values);
        fields.push_back("etao");
        c.hmget("favorites", fields, getvalues);
        OUT(getvalues.size());
        for(int i=0; i<getvalues.size(); ++i) {
            OUT(getvalues[i]);
        }

        redis::client::string_pair_vector pairs;
        c.hgetall("favorites", pairs);
        OUT(pairs.size());
        for(int i=0; i<pairs.size(); ++i) {
            OUT(pairs[i].first);
            OUT(pairs[i].second);
        }

        OUT(c.hset("favorites", "etao", "www.etao.com"));
        OUT(c.hlen("favorites"));
        pairs.clear();
        c.hdel("favorites", "etao");
        c.hdel("favorites", "koubei");
        c.hgetall("favorites", pairs);
        OUT(pairs.size());
        for(int i=0; i<pairs.size(); ++i) {
            OUT(pairs[i].first);
            OUT(pairs[i].second);
        }

        OUT(c.hexists("favorites", "taobao"));
        OUT(c.hexists("favorites", "koubei"));
    }

    test("hincrby & hkeys & hvals");
    {
        OUT(c.hset("lists", "age", "20"));
        OUT(c.hincrby("lists", "age", 5));
        redis::client::string_vector keys;
        c.hkeys("lists", keys);
        for(size_t i=0; i<keys.size(); ++i) {
            OUT(keys[i]);
        }
        redis::client::string_vector vals;
        c.hvals("lists", vals);
        for(size_t i=0; i<keys.size(); ++i) {
            OUT(vals[i]);
        }
    }
}