[[["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 document outlines the \u003ccode\u003eCommitOptions\u003c/code\u003e class, which is used to configure options for calls to \u003ccode\u003espanner::Client::Commit()\u003c/code\u003e, and it is now recommended to use \u003ccode\u003eOptions\u003c/code\u003e instead.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eCommitOptions\u003c/code\u003e allows users to set whether the \u003ccode\u003eCommitResult\u003c/code\u003e should include \u003ccode\u003eCommitStats\u003c/code\u003e, controlling the level of detail returned from commit operations.\u003c/p\u003e\n"],["\u003cp\u003eYou can use \u003ccode\u003eCommitOptions\u003c/code\u003e to set the priority of the commit operation using \u003ccode\u003eset_request_priority\u003c/code\u003e and \u003ccode\u003erequest_priority()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eset_transaction_tag()\u003c/code\u003e and \u003ccode\u003etransaction_tag()\u003c/code\u003e allow associating a tag with the commit transaction for tracking purposes, but this is ignored if the overload already uses \u003ccode\u003espanner::Transaction\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThere are multiple different versions of \u003ccode\u003eCommitOptions\u003c/code\u003e available to review, with version \u003ccode\u003e2.37.0-rc\u003c/code\u003e being the latest version available.\u003c/p\u003e\n"]]],[],null,["# Class CommitOptions (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_1CommitOptions)\n- [2.41.0](/cpp/docs/reference/spanner/2.41.0/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions)\n- [2.40.0](/cpp/docs/reference/spanner/2.40.0/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions)\n- [2.39.0](/cpp/docs/reference/spanner/2.39.0/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions)\n- [2.38.0](/cpp/docs/reference/spanner/2.38.0/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions)\n- [2.37.0](/cpp/docs/reference/spanner/2.37.0/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions)\n- [2.36.0](/cpp/docs/reference/spanner/2.36.0/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions)\n- [2.35.0](/cpp/docs/reference/spanner/2.35.0/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions)\n- [2.34.0](/cpp/docs/reference/spanner/2.34.0/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions)\n- [2.33.0](/cpp/docs/reference/spanner/2.33.0/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions)\n- [2.32.0](/cpp/docs/reference/spanner/2.32.0/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions)\n- [2.31.0](/cpp/docs/reference/spanner/2.31.0/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions)\n- [2.30.0](/cpp/docs/reference/spanner/2.30.0/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions)\n- [2.29.0](/cpp/docs/reference/spanner/2.29.0/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions)\n- [2.28.0](/cpp/docs/reference/spanner/2.28.0/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions)\n- [2.27.0](/cpp/docs/reference/spanner/2.27.0/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions)\n- [2.26.0](/cpp/docs/reference/spanner/2.26.0/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions)\n- [2.25.1](/cpp/docs/reference/spanner/2.25.1/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions)\n- [2.24.0](/cpp/docs/reference/spanner/2.24.0/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions)\n- [2.23.0](/cpp/docs/reference/spanner/2.23.0/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions)\n- [2.22.1](/cpp/docs/reference/spanner/2.22.1/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions)\n- [2.21.0](/cpp/docs/reference/spanner/2.21.0/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions)\n- [2.20.0](/cpp/docs/reference/spanner/2.20.0/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions)\n- [2.19.0](/cpp/docs/reference/spanner/2.19.0/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions)\n- [2.18.0](/cpp/docs/reference/spanner/2.18.0/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions)\n- [2.17.0](/cpp/docs/reference/spanner/2.17.0/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions)\n- [2.16.0](/cpp/docs/reference/spanner/2.16.0/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions)\n- [2.15.1](/cpp/docs/reference/spanner/2.15.1/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions)\n- [2.14.0](/cpp/docs/reference/spanner/2.14.0/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions)\n- [2.13.0](/cpp/docs/reference/spanner/2.13.0/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions)\n- [2.12.0](/cpp/docs/reference/spanner/2.12.0/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions)\n- [2.11.0](/cpp/docs/reference/spanner/2.11.0/classgoogle_1_1cloud_1_1spanner_1_1CommitOptions) \nSet options on calls to [`spanner::Client::Commit()`](/cpp/docs/reference/spanner/latest/classgoogle_1_1cloud_1_1spanner_1_1Client#classgoogle_1_1cloud_1_1spanner_1_1Client_1ae83521aef8045ac04b0a5dc85b08a2d9). \n| **Deprecated:** Use [`Options`](https://cloud.google.com/cpp/docs/reference/common/latest/classgoogle_1_1cloud_1_1Options.html) instead, and set (as needed) [`CommitReturnStatsOption`](/cpp/docs/reference/spanner/latest/structgoogle_1_1cloud_1_1spanner_1_1CommitReturnStatsOption), [`RequestPriorityOption`](/cpp/docs/reference/spanner/latest/structgoogle_1_1cloud_1_1spanner_1_1RequestPriorityOption), or [`TransactionTagOption`](/cpp/docs/reference/spanner/latest/structgoogle_1_1cloud_1_1spanner_1_1TransactionTagOption).\n\n###### Example\n\n auto commit = client.Commit(\n spanner::Mutations{\n spanner::UpdateMutationBuilder(\n \"Albums\", {\"SingerId\", \"AlbumId\", \"MarketingBudget\"})\n .EmplaceRow(1, 1, 200000)\n .EmplaceRow(2, 2, 400000)\n .Build()},\n google::cloud::Options{}.set\u003cspanner::CommitReturnStatsOption\u003e(true));\n\nConstructors\n------------\n\n### CommitOptions()\n\nDefault options: no stats.\n\n### CommitOptions(Options const \\&)\n\nConstructs from the new, recommended way to represent options of all varieties, [`google::cloud::Options`](https://cloud.google.com/cpp/docs/reference/common/latest/classgoogle_1_1cloud_1_1Options.html).\n\nOperators\n---------\n\n### operator Options() const\n\nConverts to the new, recommended way to represent options of all varieties, [`google::cloud::Options`](https://cloud.google.com/cpp/docs/reference/common/latest/classgoogle_1_1cloud_1_1Options.html).\n\nFunctions\n---------\n\n### set_return_stats(bool)\n\nSet whether the [`CommitResult`](/cpp/docs/reference/spanner/latest/structgoogle_1_1cloud_1_1spanner_1_1CommitResult) should contain [`CommitStats`](/cpp/docs/reference/spanner/latest/structgoogle_1_1cloud_1_1spanner_1_1CommitStats).\n\n### return_stats() const\n\nWhether the [`CommitResult`](/cpp/docs/reference/spanner/latest/structgoogle_1_1cloud_1_1spanner_1_1CommitResult) should contain [`CommitStats`](/cpp/docs/reference/spanner/latest/structgoogle_1_1cloud_1_1spanner_1_1CommitStats).\n\n### set_request_priority(absl::optional\\\u003c RequestPriority \\\u003e)\n\nSet the priority of the [`spanner::Client::Commit()`](/cpp/docs/reference/spanner/latest/classgoogle_1_1cloud_1_1spanner_1_1Client#classgoogle_1_1cloud_1_1spanner_1_1Client_1ae83521aef8045ac04b0a5dc85b08a2d9) call.\n\n### request_priority() const\n\nThe priority of the [`spanner::Client::Commit()`](/cpp/docs/reference/spanner/latest/classgoogle_1_1cloud_1_1spanner_1_1Client#classgoogle_1_1cloud_1_1spanner_1_1Client_1ae83521aef8045ac04b0a5dc85b08a2d9) call.\n\n### set_transaction_tag(absl::optional\\\u003c std::string \\\u003e)\n\nSet the transaction tag for the [`spanner::Client::Commit()`](/cpp/docs/reference/spanner/latest/classgoogle_1_1cloud_1_1spanner_1_1Client#classgoogle_1_1cloud_1_1spanner_1_1Client_1ae83521aef8045ac04b0a5dc85b08a2d9) call. \nIgnored for the overload that already takes a [`spanner::Transaction`](/cpp/docs/reference/spanner/latest/classgoogle_1_1cloud_1_1spanner_1_1Transaction).\n\n### transaction_tag() const\n\nThe transaction tag for the [`spanner::Client::Commit()`](/cpp/docs/reference/spanner/latest/classgoogle_1_1cloud_1_1spanner_1_1Client#classgoogle_1_1cloud_1_1spanner_1_1Client_1ae83521aef8045ac04b0a5dc85b08a2d9) call.\n\n### set_max_commit_delay(absl::optional\\\u003c std::chrono::milliseconds \\\u003e)\n\n### max_commit_delay() const"]]