Questa pagina descrive come impostare un timeout per le transazioni utilizzando le librerie client di Spanner. La transazione non va a buon fine con un errore DEADLINE_EXCEEDED se non può essere completata entro il valore di timeout specificato.
Se l'errore di timeout si verifica durante l'esecuzione della richiesta Commit, è comunque possibile che sia stato eseguito il commit della transazione.
Timeout RPC e loop di nuovi tentativi di transazione
I timeout RPC e i timeout delle transazioni limitano ambiti di lavoro diversi:
- Un timeout RPC limita il tempo di esecuzione di una singola richiesta, ad esempio una query, una lettura o una richiesta
Commit. Un timeout della transazione più lungo di un timeout RPC non estende il timeout RPC. Per saperne di più, consulta Configura timeout e tentativi personalizzati. - Un timeout della transazione limita il tempo totale impiegato dalla libreria client per eseguire una transazione di lettura/scrittura, incluso ogni tentativo effettuato dalla libreria client dopo che Spanner ha interrotto la transazione.
Quando Spanner interrompe una transazione di lettura/scrittura, la libreria client esegue nuovamente la funzione della transazione. I timeout RPC brevi non limitano il tempo per cui la libreria client continua a riprovare una transazione interrotta. Se non imposti un timeout della transazione, il comportamento di ripetizione predefinito dipende dalla libreria client:
- Java: l'esecutore delle transazioni riprova le transazioni interrotte per un massimo di 24 ore, senza limiti al numero di tentativi.
- Go: la libreria client riprova le transazioni interrotte fino a quando non viene eseguito il commit della transazione o fino a quando l'oggetto
context.Contextche passi alla transazione non raggiunge la scadenza o non viene annullato. - Node.js: la libreria client interrompe i nuovi tentativi di transazioni interrotte dopo 1 ora (
3600000millisecondi). Per modificare questo limite, imposta il campotimeoutnell'oggettoRunTransactionOptionsche passi al metodorunTransactionorunTransactionAsync. - Python: la libreria client interrompe i nuovi tentativi di transazioni interrotte dopo 30 secondi. Per modificare questo limite, passa l'argomento
timeout_secsal metodorun_in_transaction.
Nei workload con un'elevata contesa dei blocchi, ogni tentativo di ripetizione compete per gli stessi blocchi, pertanto un ciclo di ripetizione lungo può aumentare i tempi di attesa dei blocchi per altre transazioni. Per limitare il tempo totale di esecuzione di una transazione, imposta un timeout della transazione come mostrato negli esempi in questa pagina.
Imposta un timeout della transazione
Puoi impostare un timeout della transazione utilizzando le librerie client Go, Java, Python e Node.js.
Vai
Java
Node.js
Python
Imposta un timeout per le transazioni Java asincrone
L'esempio Java in questa pagina utilizza un oggetto gRPC Context con una scadenza per impostare il timeout della transazione. L'oggetto gRPC Context è collegato al thread
corrente.
Quando esegui una transazione in modo asincrono utilizzando il metodo AsyncRunner.runAsync(), la libreria client esegue la transazione sull'oggetto Executor che fornisci. La libreria client non propaga l'oggetto Context del thread chiamante, inclusa la scadenza, all'esecutore. Di conseguenza, la transazione viene eseguita senza timeout e può continuare a riprovare i tentativi interrotti per un massimo di 24 ore.
Per applicare il timeout a una transazione asincrona, esegui una delle seguenti operazioni:
- Aggrega l'esecutore chiamando il metodo
Context.currentContextExecutor(executor)mentre l'oggettoContextcon la scadenza è corrente e passa l'esecutore aggregato al metodorunAsync(). - Utilizza l'interfaccia
AsyncTransactionManageroTransactionManageranziché l'interfacciaAsyncRunner. Con un gestore delle transazioni, scrivi tu il loop di nuovi tentativi e puoi interromperli alla scadenza del timeout.