iNexus Key-Value 数据库

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