本頁面說明如何使用 Spanner 用戶端程式庫設定交易逾時。如果交易無法在指定的逾時值內完成,就會失敗並顯示 DEADLINE_EXCEEDED 錯誤。
如果在執行 Commit 要求時發生逾時錯誤,交易仍有可能已提交。
RPC 逾時和交易重試迴圈
RPC 逾時和交易逾時會限制不同的工作範圍:
- RPC 逾時會限制單一要求 (例如查詢、讀取或
Commit要求) 的執行時間長度。如果交易逾時時間長於 RPC 逾時時間,RPC 逾時時間不會延長。詳情請參閱「設定自訂逾時和重試」。 - 交易逾時會限制用戶端程式庫執行讀寫交易的總時間,包括 Spanner 中止交易後,用戶端程式庫進行的每次嘗試。
Spanner 中止讀寫交易時,用戶端程式庫會重新執行交易函式。RPC 逾時時間短,並不會限制用戶端程式庫重試已取消交易的時間長度。如未設定交易逾時,預設重試行為會因用戶端程式庫而異:
- Java:交易執行工具會重試已取消的交易,最長可達 24 小時,且不限嘗試次數。
- Go:用戶端程式庫會重試已取消的交易,直到交易提交,或傳遞至交易的
context.Context物件達到期限或取消為止。 - Node.js:用戶端程式庫會在 1 小時 (
3600000毫秒) 後停止重試已取消的交易。如要變更這項限制,請在傳遞至runTransaction或runTransactionAsync方法的RunTransactionOptions物件中,設定timeout欄位。 - Python:用戶端程式庫會在 30 秒後停止重試已取消的交易。如要變更這項限制,請將
timeout_secs引數傳遞至run_in_transaction方法。
在鎖定競爭激烈的工作負載中,每次重試都會爭奪相同的鎖定,因此長時間的重試迴圈可能會增加其他交易的鎖定等待時間。如要限制交易的總執行時間,請設定交易逾時時間,如本頁範例所示。
設定交易逾時
您可以使用 Go、Java、Python 和 Node.js 用戶端程式庫設定交易逾時。
Go
Java
Node.js
Python
設定非同步 Java 交易的逾時時間
本頁的 Java 範例使用具有期限的 gRPC Context 物件,設定交易逾時。gRPC Context 物件會附加至目前執行緒。
使用 AsyncRunner.runAsync() 方法非同步執行交易時,用戶端程式庫會對您提供的 Executor 物件執行交易。用戶端程式庫不會將呼叫執行緒的 Context 物件 (包括期限) 傳播至該執行器。因此,交易執行時不會逾時,且最多可持續重試 24 小時。
如要將逾時設定套用至非同步交易,請執行下列任一操作:
- 在具有期限的
Context物件為目前物件時,呼叫Context.currentContextExecutor(executor)方法來包裝執行器,並將包裝後的執行器傳遞至runAsync()方法。 - 請使用
AsyncTransactionManager或TransactionManager介面,而非AsyncRunner介面。使用交易管理工具時,您必須自行編寫重試迴圈,並在逾時到期時停止重試。