Auf dieser Seite wird beschrieben, wie Sie mithilfe der Spanner-Clientbibliotheken ein Zeitlimit für Transaktionen festlegen. Die Transaktion schlägt mit dem Fehler DEADLINE_EXCEEDED fehl, wenn sie nicht innerhalb des angegebenen Zeitlimits abgeschlossen werden kann.
Wenn der Zeitüberschreitungsfehler während der Ausführung der Commit-Anfrage auftritt, ist es dennoch möglich, dass die Transaktion festgeschrieben wurde.
RPC-Zeitüberschreitungen und Transaktionswiederholungsschleifen
RPC-Zeitlimits und Transaktionszeitlimits beschränken unterschiedliche Arbeitsbereiche:
- Ein RPC-Zeitlimit begrenzt, wie lange eine einzelne Anfrage, z. B. eine Abfrage, ein Lesevorgang oder eine
Commit-Anfrage, ausgeführt werden kann. Ein Transaktionszeitlimit, das länger als ein RPC-Zeitlimit ist, verlängert das RPC-Zeitlimit nicht. Weitere Informationen finden Sie unter Benutzerdefinierte Zeitlimits und Wiederholungsversuche konfigurieren. - Ein Transaktionszeitlimit begrenzt die Gesamtzeit, die die Clientbibliothek für die Ausführung einer Lese-/Schreibtransaktion benötigt, einschließlich aller Versuche, die die Clientbibliothek unternimmt, nachdem Spanner die Transaktion abgebrochen hat.
Wenn Spanner eine Lese-/Schreibtransaktion abbricht, führt die Clientbibliothek die Transaktionsfunktion noch einmal aus. Kurze RPC-Zeitlimits schränken nicht ein, wie lange die Clientbibliothek versucht, eine abgebrochene Transaktion zu wiederholen. Wenn Sie kein Transaktionszeitlimit festlegen, hängt das Standardverhalten für Wiederholungsversuche von der Clientbibliothek ab:
- Java: Der Transaktions-Runner wiederholt abgebrochene Transaktionen bis zu 24 Stunden lang. Die Anzahl der Versuche ist nicht begrenzt.
- Go: Die Clientbibliothek wiederholt abgebrochene Transaktionen, bis die Transaktion festgeschrieben wird oder bis das
context.Context-Objekt, das Sie an die Transaktion übergeben, seine Frist erreicht oder abgebrochen wird. - Node.js: Die Clientbibliothek beendet die Wiederholung abgebrochener Transaktionen nach 1 Stunde (
3600000Millisekunden). Wenn Sie dieses Limit ändern möchten, legen Sie das Feldtimeoutim ObjektRunTransactionOptionsfest, das Sie an die MethoderunTransactionoderrunTransactionAsyncübergeben. - Python: Die Clientbibliothek beendet die Wiederholung abgebrochener Transaktionen nach 30 Sekunden. Wenn Sie dieses Limit ändern möchten, übergeben Sie das Argument
timeout_secsan die Methoderun_in_transaction.
Bei Arbeitslasten mit hoher Sperrenkonkurrenz konkurriert jeder Wiederholungsversuch um dieselben Sperren. Eine lange Wiederholungsschleife kann daher die Sperrenwartezeiten für andere Transaktionen erhöhen. Wenn Sie die Gesamtzeit, die eine Transaktion ausgeführt werden kann, begrenzen möchten, legen Sie ein Transaktionszeitlimit fest, wie in den Beispielen auf dieser Seite gezeigt.
Zeitlimit für Transaktionen festlegen
Sie können ein Transaktionszeitlimit mit den Go-, Java-, Python- und Node.js-Clientbibliotheken festlegen.
Go
Java
Node.js
Python
Zeitlimit für asynchrone Java-Transaktionen festlegen
Im Java-Beispiel auf dieser Seite wird ein gRPC-Context-Objekt mit einer Frist verwendet, um das Transaktionszeitlimit festzulegen. Das gRPC-Context-Objekt ist an den aktuellen Thread angehängt.
Wenn Sie eine Transaktion asynchron mit der Methode AsyncRunner.runAsync() ausführen, führt die Clientbibliothek die Transaktion für das von Ihnen bereitgestellte Executor-Objekt aus. Die Clientbibliothek gibt das Context-Objekt des aufrufenden Threads, einschließlich seiner Frist, nicht an diesen Executor weiter. Daher wird die Transaktion ohne Zeitüberschreitung ausgeführt und abgebrochene Versuche können bis zu 24 Stunden lang wiederholt werden.
So wenden Sie das Zeitlimit auf eine asynchrone Transaktion an:
- Verpacken Sie den Executor, indem Sie die Methode
Context.currentContextExecutor(executor)aufrufen, während dasContext-Objekt mit der Frist aktuell ist, und übergeben Sie den verpackten Executor an die MethoderunAsync(). - Verwenden Sie die Schnittstelle
AsyncTransactionManageroderTransactionManageranstelle der SchnittstelleAsyncRunner. Mit einem Transaktionsmanager schreiben Sie die Wiederholungsschleife selbst und können die Wiederholungsversuche beenden, wenn das Zeitlimit abläuft.