调用StartLocalTransaction接口创建一个局部事务。为数据表开启局部事务后,使用局部事务功能,您可以创建数据范围在一个分区键值内的局部事务并对局部事务中的数据进行读写操作。通过使用局部事务您可以实现单行或多行读写的原子操作。
注意事项
目前局部事务功能处于邀测中,默认关闭。如果需要使用该功能,请提交工单进行申请或者加入钉钉群36165029092(表格存储技术交流群-3)进行咨询。
重要使用Java SDK 5.11.0及以上版本时,您可以在创建数据表时开启局部事务。更多信息,请参见数据表操作。
主键自增列功能和局部事务功能不能同时使用。
请求消息结构
message StartLocalTransactionRequest {
required string table_name = 1;
required bytes key = 2;
}
名称 | 类型 | 是否必选 | 描述 |
table_name | string | 是 | 数据表名称。 |
key | bytes | 是 | 数据表的分区键值,由Plainbuffer编码,详见Plainbuffer编码。 |
响应消息结构
message StartLocalTransactionResponse {
required string transaction_id = 1;
}
名称 | 类型 | 是否必选 | 描述 |
transaction_id | string | 是 | 局部事务ID。 |
使用SDK
您可以使用如下语言的SDK使用局部事务。
Java SDK:局部事务
Go SDK:局部事务
Python SDK:局部事务
Node.js SDK:局部事务
PHP SDK:局部事务