Txn 方法
txn 请求增加键值存储的修订版本并为每个完成的请求生成带有相同修订版本的事件。
不容许在一个 txn 中多次修改同一个 key。
消息体
message TxnRequest {
// compare 是断言列表,体现为条件的联合。
// 如果比较成功,那么成功请求将被按顺序处理,而应答将按顺序包含他们对应的应答。
// 如果比较失败,那么失败请求将被按顺序处理,而应答将按顺序包含他们对应的应答。
repeated Compare compare = 1;
// 成功请求列表,当比较评估为 true 时将被应用。
repeated RequestOp success = 2;
// 失败请求列表,当比较评估为 false 时将被应用。
repeated RequestOp failure = 3;
}
应答的消息体是 TxnResponse
:
Compare
消息体:
message Compare {
enum CompareResult {
EQUAL = 0;
LESS = 2;
NOT_EQUAL = 3;
}
enum CompareTarget {
VERSION = 0;
CREATE = 1;
MOD = 2;
VALUE= 3;
}
// result 是这个比较的逻辑比较操作
CompareResult result = 1;
// target 是比较要检查的键值字段
CompareTarget target = 2;
// key 是用于比较操作的主题key
bytes key = 3;
oneof target_union {
int64 version = 4;
// create_revision 是给定 key 的创建修订版本
int64 create_revision = 5;
// mod_revision 是给定 key 的最后修改修订版本
int64 mod_revision = 6;
// value 是给定 key 的值,以 bytes 的形式
bytes value = 7;
}
}
ResponseOp
消息体:
message ResponseOp {
// response 是事务返回的应答类型的联合
oneof response {
RangeResponse response_range = 1;
PutResponse response_put = 2;
DeleteRangeResponse response_delete_range = 3;
}