Key-Value 数据库:iNexus

jopen 9年前

iNexus (简称ins) 是一个基于 Raft 协议实现的高可用的分布式 Key-Value 数据库,支持数据变更通知(Watch)和分布式锁,可用于大型分布式系统的协调工作。

使用说明:

https://github.com/fxsjy/ins/wiki    

1. 初始化 Client

using namespace galaxy::ins::sdk;  InsSDK* sdk = new InsSDK("abc.com:1234,def.com:1234")  //构造函数传入ins集群的若干个member(机器名+端口), 用逗号分隔。

2. 随机读

galaxy::ins::sdk::SDKError err;  std::string key = "key_123";  std::string value;  bool ret = sdk->Get(key, &value, &err));  // ret == true表示成功读取  // ret == false表示读取失败或者改key不存在  // err返回错误码,kOK表示无错误, kNoSuchKey表示key不存在(具体参见ins_sdk.h)。

   3. 区间扫描

std::string start_key = "a";  std::string end_key = "z";  galaxy::ins::sdk::ScanResult* result = sdk->Scan(start_key, end_key); //不包含end_key  while (!result->Done()) { //通过一个流式迭代器读取scan的结果      assert(result->Error() == galaxy::ins::sdk::kOK);      std::string value = result->Value();       std::string key = result->Key();      result->Next();  }

   4. 分布式锁

galaxy::ins::sdk::SDKError err;  std::string lock_name = "/ps/se/ac";  sdk->Lock(lock_name, &err);   // Lock会一直阻塞直到抢到锁  // sdk通过心跳和iNexus集群保持活跃,一旦超过一定时间(默认6秒),该sdk加的锁自动失效,可以被其他client抢得。  sdk->TryLock(lock_name, &err); // TryLock不会阻塞,如果调用者抢不到锁,就返回false, 用户自己决定重试策略

   5. Watch数据变更

watch支持直接watch一个key,也支持watch 一些key的"父节点".  galaxy::ins::sdk::SDKError err;  sdk->Watch("/ps/se/tera/ts", OnChildrenChange, context, &err); //第二个参数是回调函数,第三个参数是回调函数可以用的用户自定义数据  sdk->Watch("/ps/se/tera/master_lock", OnLockChange, context, &err);

  快速体验:
(只需要一台机器,通过多个进程模拟分布式)

cd sandbox  ./start_all.sh  ./ins_shell.sh    galaxy ins> help    show [ show cluster ]    put (key) (value) [ update the data ]     get (key) [read the data by key ]    delete (key) [remove the data by key]    scan (start-key) (end-key) [scan from start-key to end-key(excluded)]    watch (key) [event will be triggered once value changed or deleted]    lock (key) [lock on specific key]    enter quit to exit shell

项目主页:http://www.open-open.com/lib/view/home/1435200336403