The base class for the Spanner library transaction rerun policies.
The Client::Commit() functions (there are several overloads) consume a callable to create mutations or a list of mutations. Commit() creates a transaction and applies the mutations. If the transaction fails, an instance of this class is used to control whether the transaction will be attempted again.
Functions
clone() const
Creates a new instance of the policy, reset to the initial state.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-14 UTC."],[[["\u003cp\u003eThis webpage provides documentation for the \u003ccode\u003eTransactionRerunPolicy\u003c/code\u003e class within the Google Cloud Spanner C++ client library, outlining its role in managing transaction retries.\u003c/p\u003e\n"],["\u003cp\u003eThe documentation covers a range of versions for the library, from 2.11.0 up to the latest release candidate 2.37.0-rc, each with its own specific reference page for this policy class.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eTransactionRerunPolicy\u003c/code\u003e class dictates if a failed transaction created by the \u003ccode\u003eClient::Commit()\u003c/code\u003e function should be attempted again, with functions to check if a failure is permanent or if retries are exhausted.\u003c/p\u003e\n"],["\u003cp\u003eThe policy includes functions like \u003ccode\u003eclone()\u003c/code\u003e, \u003ccode\u003eOnFailure(Status const &)\u003c/code\u003e, \u003ccode\u003eIsExhausted()\u003c/code\u003e, and \u003ccode\u003eIsPermanentFailure(Status const &)\u003c/code\u003e for managing the state and behavior of transaction retries.\u003c/p\u003e\n"]]],[],null,["# Class TransactionRerunPolicy (2.42.0-rc)\n\nVersion latestkeyboard_arrow_down\n\n- [2.42.0-rc (latest)](/cpp/docs/reference/spanner/latest/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.41.0](/cpp/docs/reference/spanner/2.41.0/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.40.0](/cpp/docs/reference/spanner/2.40.0/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.39.0](/cpp/docs/reference/spanner/2.39.0/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.38.0](/cpp/docs/reference/spanner/2.38.0/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.37.0](/cpp/docs/reference/spanner/2.37.0/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.36.0](/cpp/docs/reference/spanner/2.36.0/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.35.0](/cpp/docs/reference/spanner/2.35.0/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.34.0](/cpp/docs/reference/spanner/2.34.0/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.33.0](/cpp/docs/reference/spanner/2.33.0/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.32.0](/cpp/docs/reference/spanner/2.32.0/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.31.0](/cpp/docs/reference/spanner/2.31.0/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.30.0](/cpp/docs/reference/spanner/2.30.0/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.29.0](/cpp/docs/reference/spanner/2.29.0/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.28.0](/cpp/docs/reference/spanner/2.28.0/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.27.0](/cpp/docs/reference/spanner/2.27.0/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.26.0](/cpp/docs/reference/spanner/2.26.0/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.25.1](/cpp/docs/reference/spanner/2.25.1/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.24.0](/cpp/docs/reference/spanner/2.24.0/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.23.0](/cpp/docs/reference/spanner/2.23.0/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.22.1](/cpp/docs/reference/spanner/2.22.1/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.21.0](/cpp/docs/reference/spanner/2.21.0/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.20.0](/cpp/docs/reference/spanner/2.20.0/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.19.0](/cpp/docs/reference/spanner/2.19.0/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.18.0](/cpp/docs/reference/spanner/2.18.0/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.17.0](/cpp/docs/reference/spanner/2.17.0/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.16.0](/cpp/docs/reference/spanner/2.16.0/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.15.1](/cpp/docs/reference/spanner/2.15.1/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.14.0](/cpp/docs/reference/spanner/2.14.0/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.13.0](/cpp/docs/reference/spanner/2.13.0/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.12.0](/cpp/docs/reference/spanner/2.12.0/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy)\n- [2.11.0](/cpp/docs/reference/spanner/2.11.0/classgoogle_1_1cloud_1_1spanner_1_1TransactionRerunPolicy) \nThe base class for the Spanner library transaction rerun policies. \nThe [`Client::Commit()`](/cpp/docs/reference/spanner/latest/classgoogle_1_1cloud_1_1spanner_1_1Client#classgoogle_1_1cloud_1_1spanner_1_1Client_1ae83521aef8045ac04b0a5dc85b08a2d9) functions (there are several overloads) consume a callable to create mutations or a list of mutations. `Commit()` creates a transaction and applies the mutations. If the transaction fails, an instance of this class is used to control whether the transaction will be attempted again.\n\nFunctions\n---------\n\n### clone() const\n\nCreates a new instance of the policy, reset to the initial state.\n\n### OnFailure(Status const \\&)\n\n### OnFailure(Status const \\&)\n\n### IsExhausted() const\n\n### IsExhausted() const\n\n### IsPermanentFailure(Status const \\&) const\n\n### IsPermanentFailure(Status const \\&) const"]]