Nesta página, descrevemos como definir um tempo limite para transações usando as
bibliotecas de cliente do Spanner. A transação falhará com um erro DEADLINE_EXCEEDED se não puder ser concluída dentro do valor de tempo limite fornecido.
Se o erro de tempo limite ocorrer durante a execução da solicitação Commit, ainda é possível que a transação tenha sido confirmada.
Tempos limite de RPC e loops de repetição de transação
Os tempos limite de RPC e de transação limitam diferentes escopos de trabalho:
- Um tempo limite de RPC limita por quanto tempo uma única solicitação, como uma consulta, uma leitura ou uma solicitação
Commit, pode ser executada. Um tempo limite de transação maior que o de RPC não estende o tempo limite de RPC. Para mais informações, consulte Configurar tempos limite e novas tentativas personalizados. - Um tempo limite de transação limita o tempo total que a biblioteca de cliente gasta executando uma transação de leitura e gravação, incluindo todas as tentativas que a biblioteca de cliente faz depois que o Spanner cancela a transação.
Quando o Spanner cancela uma transação de leitura e gravação, a biblioteca de cliente executa novamente a função de transação. Os tempos limite curtos de RPC não limitam o tempo que a biblioteca de cliente continua tentando uma transação cancelada. Se você não definir um tempo limite de transação, o comportamento de repetição padrão vai depender da biblioteca de cliente:
- Java: o executor de transações tenta novamente as transações canceladas por até 24 horas, sem limite no número de tentativas.
- Go: a biblioteca de cliente repete as transações canceladas até que elas sejam confirmadas ou até que o objeto
context.Contexttransmitido à transação atinja o prazo ou seja cancelado. - Node.js: a biblioteca de cliente para de tentar novamente as transações canceladas após
1 hora (
3600000milissegundos). Para mudar esse limite, defina o campotimeoutno objetoRunTransactionOptionsque você transmite para o métodorunTransactionourunTransactionAsync. - Python: a biblioteca de cliente para de tentar novamente as transações canceladas após
30 segundos. Para mudar esse limite, transmita o argumento
timeout_secspara o métodorun_in_transaction.
Em cargas de trabalho com alta contenção de bloqueio, cada tentativa de repetição compete pelos mesmos bloqueios. Portanto, um loop de repetição longo pode aumentar o tempo de espera de bloqueio para outras transações. Para limitar o tempo total de execução de uma transação, defina um tempo limite de transação, conforme mostrado nos exemplos desta página.
Definir um tempo limite de transação
É possível definir um tempo limite de transação usando as bibliotecas de cliente do Go, Java, Python e Node.js.
Go
Java
Node.js
Python
Definir um tempo limite para transações Java assíncronas
O exemplo de Java nesta página usa um objeto gRPC Context com um prazo para definir
o tempo limite da transação. O objeto gRPC Context é anexado à linha de execução
atual.
Quando você executa uma transação de forma assíncrona usando o método AsyncRunner.runAsync(),
a biblioteca de cliente executa a transação no objeto Executor que
você fornece. A biblioteca de cliente não propaga o objeto Context da linha de execução de chamada, incluindo o prazo, para esse executor. Como resultado, a transação é executada sem o tempo limite e pode continuar tentando novamente as tentativas canceladas por até 24 horas.
Para aplicar o tempo limite a uma transação assíncrona, siga um destes procedimentos:
- Encapsule o executor chamando o método
Context.currentContextExecutor(executor)enquanto o objetoContextque tem o prazo é atual e transmita o executor encapsulado para o métodorunAsync(). - Use a interface
AsyncTransactionManagerouTransactionManagerem vez da interfaceAsyncRunner. Com um gerenciador de transações, você escreve o loop de repetição por conta própria e pode interromper as tentativas quando o tempo limite expirar.