Todos os produtos
Search
Central de documentação

Tablestore:StartLocalTransaction

Última atualização: Sep 09, 2026

Chame a operação StartLocalTransaction para criar uma transação local. Com o recurso de transação local ativado em uma tabela de dados, é possível criar transações com escopo limitado a um único valor de chave de partição. Isso permite executar operações atômicas de leitura e escrita em uma ou mais linhas.

Precauções

  • Ative as transações locais ao criar a tabela de dados. Use o console do Tablestore, o Tablestore SDK for Java V5.11.0 ou posterior, ou a versão mais recente do Tablestore SDK for Go. Para mais informações, consulte Crie uma tabela de dados.

    Importante

    Se você precisar de transações locais em uma tabela de dados existente sem esse recurso ativado na criação, envie um ticket. Também é possível entrar no grupo 36165029092 do DingTalk (Grupo de Discussão Técnica do Tablestore-3) para obter assistência

  • Os recursos de chave primária com incremento automático e de transação local são incompatíveis entre si.

Estrutura da mensagem de solicitação

message StartLocalTransactionRequest {
    required string table_name = 1;
    required bytes key = 2;
}

Nome

Tipo

Obrigatório

Descrição

table_name

string

Sim

Nome da tabela de dados.

key

bytes

Sim

Valor da chave de partição da tabela de dados, codificado no formato Plainbuffer. Para mais detalhes, consulte Plainbuffer encoding.

Estrutura da mensagem de resposta

message StartLocalTransactionResponse {
    required string transaction_id = 1;
}

Nome

Tipo

Obrigatório

Descrição

transaction_id

string

Sim

ID da transação local.

Uso do SDK

Use transações locais com os seguintes SDKs: