int getKV(const GetKVReq &req, GetKVRsp &rsp)

struct GetKVReq {
  1 require string moduleName; //module name
  2 require string keyItem;
  3 require string idcSpecified = ""; //idc area
};

struct GetKVRsp {
  1 require string value;
  2 require byte ver; //Data version number
  3 require int expireTime = 0; //expiration time
};

int getKVBatch(const GetKVBatchReq &req, GetKVBatchRsp &rsp)

struct GetKVBatchReq {
  1 require string moduleName; //module name
  2 require vector<string> keys; //set of keys
  3 require string idcSpecified = ""; //idc area
};

struct GetKVBatchRsp {
  1 require vector<SKeyValue> values; //set of results
};

int checkKey(const CheckKeyReq &req, CheckKeyRsp &rsp)

struct CheckKeyReq {
  1 require string moduleName; //module name
  2 require vector<string> keys; //set of keys
  3 require string idcSpecified = ""; //idc area
};

struct CheckKeyRsp {
  1 require map<string, SKeyStatus> keyStat;
};

struct SKeyStatus {
  1 require bool exist; //whether the data exists
  2 require bool dirty; //whether the data is dirty
};

int getAllKeys(const GetAllKeysReq &req, GetAllKeysRsp &rsp)

struct GetAllKeysReq
{
  1 require string moduleName;  //имя модуля
  2 require int index;  //перебор начиная с указанного индекса хэш-корзины, начиная с 0
  3 require int count;  //количество хэш-корзин для перебора
  4 require string idcSpecified = "";  //область idc
}；

struct GetAllKeysRsp
{
  1 require vector<string> keys;  //набор ключей
  2 require bool isEnd;   //поскольку количество корзин неизвестно, параметр isEnd используется для указания, есть ли корзина, которая не была пройдена
};

int setKV(const SetKVReq &req)

struct SetKVReq
{
  1 require string moduleName;  //имя модуля
  2 require SSetKeyValue data;
};

struct SSetKeyValue
{
  1 require string keyItem;  
  2 require string value;  
  3 require byte   version = 0;  //номер версии данных
  4 require bool   dirty = true;  //сделать данные грязными
  5 require int    expireTimeSecond = 0;  //время истечения срока действия, по умолчанию 0, что означает никогда не истечёт
};

int insertKV(const SetKVReq &req)

struct SetKVReq
{
  1 require string moduleName;  //имя модуля
  2 require SSetKeyValue data;
};

struct SSetKeyValue
{
  1 require string keyItem;  
  2 require string value;  
  3 require byte   version = 0;  //номер версии данных
  4 require bool   dirty = true;  //сделать данные грязными
  5 require int    expireTimeSecond = 0;  //время истечения срока действия, по умолчанию 0, что означает никогда не истечёт
};

int updateKV(const UpdateKVReq &req, UpdateKVRsp &rsp)

struct UpdateKVReq
{
  1 require string moduleName;  //имя модуля
  2 require SSetKeyValue data;  //данные для обновления
  3 require Op option;    //действие обновления, включая ADD/SUB/ADD_INSERT/SUB_INSERT
};

struct UpdateKVRsp
{
  1 require string retValue;
};

int eraseKV(const RemoveKVReq &req)

struct RemoveKVReq
{
  1 require string moduleName;  //имя модуля;
  2 require KeyInfo keyInfo;
};

struct KeyInfo
{
  1 require string keyItem;  
  2 require byte version;  //номер версии данных.
};

int delKV(const RemoveKVReq &req)

struct RemoveKVReq
{
  1 require string moduleName;  //имя модуля;
  2 require KeyInfo keyInfo;
};

struct KeyInfo
{
  1 require string keyItem;  
  2 require byte version;  //номер версии данных.
};

int setKVBatch(const SetKVBatchReq &req, SetKVBatchRsp &rsp)

struct SetKVBatchReq
{
  1 require string moduleName;  //имя модуля;
  2 require vector<SSetKeyValue> data;  //пакетные данные.
};

struct SetKVBatchRsp
{
  1 require map<string, int> keyResult;   //результаты вставки ключей-значений, WRITE_SUCC = 0/WRITE_ERROR = -1/WRITE_DATA_VER_MISMATCH = -2
};

int eraseKVBatch(const RemoveKVBatchReq &req, RemoveKVBatchRsp &rsp)

struct RemoveKVBatchReq
{
  1 require string moduleName;  //имя модуля;
  2 require vector<KeyInfo> data;  
};

struct KeyInfo
{
  1 require string keyItem; 
  2 require byte version;  //номер версии данных.
};

struct RemoveKVBatchRsp
{
  1 require map<string, int> keyResult;  //результаты операции удаления, WRITE_SUCC = 0/WRITE_ERROR = -1/WRITE_DATA_VER_MISMATCH = -2
};

int delKVBatch(const RemoveKVBatchReq &req, RemoveKVBatchRsp &rsp)

struct RemoveKVBatchReq
{
  1 require string moduleName;  //имя модуля;
  2 require vector<KeyInfo> data;  
};

struct KeyInfo
{
  1 require string keyItem;  
  2 require byte version;  //номер версии данных.
};

struct RemoveKVBatchRsp
{
  1 require map<string, int> keyResult;  //результаты вставки пар «ключ-значение»: WRITE_SUCC = 0/WRITE_ERROR = -1/WRITE_DATA_VER_MISMATCH = -2
};

int getMKV(const GetMKVReq &req, GetMKVRsp &rsp)

struct GetMKVReq
{
  1 require string moduleName; //имя модуля;
  2 require string mainKey;  
  3 require string field; //набор полей для запроса, несколько полей разделяются символом ',', например: «a, b», «*» для всех полей
  4 require vector<Condition> cond; //условия, используемые для фильтрации данных при запросе
  5 require bool retEntryCnt = false; //возвращать ли количество записей, где первичный ключ равен mainKey
  6 require string idcSpecified = ""; //область idc
};

struct GetMKVRsp
{
  1 require vector<map<string, string> > data; //результирующий набор
};

int getMainKeyCount(const MainKeyReq &req)

struct MainKeyReq
{
  1 require string moduleName; //имя модуля;
  2 require string mainKey;  
  3 require string idcSpecified = ""; //область idc
};

int insertMKV(const InsertMKVReq &req)

struct InsertMKVReq
{
  1 require string moduleName;  //имя модуля;
  2 require InsertKeyValue data;
};

struct InsertKeyValue
{
  1 require string mainKey;  
  2 require map<string, UpdateValue> mpValue;  //Другие поля, кроме mainKey
  3 require byte ver = 0;  //номер версии данных
  4 require bool dirty = true;  //сделать данные грязными
  5 require bool replace = false;  //перезаписать старую запись, если запись уже существует и replace равно true
  6 require int expireTimeSecond = 0; //время истечения срока действия
};

int updateMKV(const UpdateMKVReq &req)

struct UpdateMKVReq
{
  1 require string moduleName;  //имя модуля
  2 require string mainKey;  
  3 require map<string, UpdateValue> value;  //Поля, которые необходимо обновить, исключая вторичный ключ
  4 require vector<Condition> cond;  
  5 require byte ver = 0;  //номер версии данных
  6 require bool dirty = true;  //сделать данные грязными
  7 require bool insert = false; //вставить запись, если уникальная запись, которую нужно изменить, не существует, и insert == true
  8 require int expireTimeSecond = 0;  //время истечения срока действия
};

int updateMKVAtom(const UpdateMKVAtomReq &req)

struct UpdateMKVAtomReq
{
  1 require string moduleName;  //имя модуля
  2 require string mainKey;  
  3 require map<string, UpdateValue> value;  //поля, которые необходимо обновить, не включая поле вторичного ключа, op поддерживает операции SET, ADD, SUB.
  4 require vector<Condition> cond;  
  5 require bool dirty = true;  //сделать данные грязными
``` **Возвращает:**

| Возвращает | Описание |
| --- | --- |
| ET_SERVER_TYPE_ERR | сервис не предоставляется, так как это ведомый сервер |
| ET_MODULE_NAME_INVALID | ошибка модуля |
| ET_FORBID_OPT | данные мигрируют |
| ET_KEY_AREA_ERR | текущий ключ не должен быть назначен этому узлу, необходимо обновить таблицу маршрутизации для повторного доступа |
| ET_INPUT_PARAM_ERROR | ошибка параметра, например, mainKey пуст |
| ET_PARAM_UPDATE_UKEY_ERR | поля, которые должны быть обновлены, содержат поле вторичного ключа |
| ET_PARAM_DIGITAL_ERR | ошибка поля, например, поле числового типа содержит нечисловые символы |
| ET_PARAM_TOO_LONG | длина поля превышает лимит |
| ET_PARAM_NOT_EXIST | поле не существует |
| ET_PARAM_REDUNDANT | в условии есть несколько полей вторичных ключей с одинаковым именем |
| ET_PARAM_LIMIT_VALUE_ERR | значение поля с именем limit в условии неверно |
| ET_DATA_VER_MISMATCH | разные номера версий |
| ET_SYS_ERR | системная ошибка |
| другие значения (больше или равно 0) | обновление успешно, также это значение указывает на количество записей, затронутых операцией обновления |

**eraseMKV**

```C++
int eraseMKV(const MainKeyReq &req)

struct MainKeyReq
{
  1 require string moduleName; //имя модуля
  2 require string mainKey;
  3 require string idcSpecified = ""; //область idc
};

int delMKV(const DelMKVReq &req)

struct DelMKVReq
{
  1 require string moduleName; //имя модуля
  2 require string mainKey;
  3 require vector<Condition> cond;
};

struct Condition
{
  1 require string fieldName;
  2 require Op op; //операторы условия, поддерживают ==/!=/</>/<=/>=
  3 require string value;
};

int insertMKVBatch(const InsertMKVBatchReq &req, MKVBatchWriteRsp &rsp)

struct InsertMKVBatchReq
{
  1 require string moduleName; //имя модуля
  2 require vector<InsertKeyValue> data;
};

struct InsertKeyValue
{
  1 require string mainKey;
  2 require map<string, UpdateValue> mpValue; //значения полей исключая mainKey
  3 require byte ver = 0; //номер версии данных
  4 require bool dirty = true; //сделать данные грязными
  5 require bool replace = false; //перезаписать старую запись, если запись уже существует и replace истинно
  6 require int expireTimeSecond = 0; //время истечения срока действия
};

struct MKVBatchWriteRsp
{
  1 require map<int, int> rspData; //ключ: индекс поля данных в структуре запроса, значение: причина сбоя вставки, rspData пуста, если все вставки успешны
};

int delZSetByScore(const DelZSetByScoreReq &req)

struct DelZSetByScoreReq
{
  1 require string moduleName;  //имя модуля
  2 require string mainKey;  
  3 require double minScore;
  4 require double maxScore;
};

int updateZSet(const UpdateZSetReq &req)

struct UpdateZSetReq
{
  1 require string moduleName;  //имя модуля
  2 require AddSetKeyValue value;  //данные, используемые для обновления
  3 require vector<Condition> cond;
};

struct AddSetKeyValue
{
  1 require string mainKey;  
  2 require map<string, UpdateValue> data;  //данные, используемые для обновления
  3 require int expireTime;  //время истечения срока действия
  4 require bool dirty = true;  //сделать данные «грязными»
};

struct Condition
{
  1 require string fieldName;  //все поля, кроме mainKey
  2 require Op op;  //поддерживается только EQ
  3 require string value;  
};