Txn 方法
一个 txn 请求增加键值存储的修订版本并为每个完成的请求生成带有相同修订版本的事件。
不容许在一个txn中多次修改同一个key。
消息体
// compare 是断言列表,体现为条件的联合。
// 如果比较成功,那么成功请求将被按顺序处理,而应答将按顺序包含他们对应的应答。
// 如果比较失败,那么失败请求将被按顺序处理,而应答将按顺序包含他们对应的应答。
repeated Compare compare = 1;
// 成功请求列表,当比较评估为 true 时将被应用。
repeated RequestOp success = 2;
// 失败请求列表,当比较评估为 false 时将被应用。
repeated RequestOp failure = 3;
}
应答的消息体是 TxnResponse:
Compare 消息体:
message Compare {
enum CompareResult {
GREATER = 1;
LESS = 2;
}
VERSION = 0;
CREATE = 1;
MOD = 2;
VALUE= 3;
}
// result是这个比较的逻辑比较操作
CompareResult result = 1;
// target是比较要检查的键值字段
CompareTarget target = 2;
// key是用于比较操作的主题key
bytes key = 3;
// version是给定key的版本
// 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;
}