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_keywhile (!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.shgalaxy 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
评论