全部产品
Search
文档中心

表格存储:StartLocalTransaction

更新时间:May 15, 2024

调用StartLocalTransaction接口创建一个局部事务。为数据表开启局部事务后,使用局部事务功能,您可以创建数据范围在一个分区键值内的局部事务并对局部事务中的数据进行读写操作。通过使用局部事务您可以实现单行或多行读写的原子操作。

注意事项

  • 目前局部事务功能处于邀测中,默认关闭。如果需要使用该功能,请提交工单进行申请。

    重要

    使用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使用局部事务。