Options for "single-use", ReadOnly transactions, where Spanner chooses the read timestamp, subject to user-provided bounds.
This allows reading without blocking.
Because selection of the timestamp requires knowledge of which rows will be read, a single-use transaction can only be used with one read. See Client::Read() and Client::ExecuteQuery(). SingleUseOptions cannot be used to construct an application-level Transaction.
[[["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\u003eThe latest version available is 2.37.0-rc, with numerous older versions from 2.36.0 down to 2.11.0 also available for reference.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eSingleUseOptions\u003c/code\u003e are for "single-use" ReadOnly transactions, where Spanner automatically selects the read timestamp based on user-defined boundaries.\u003c/p\u003e\n"],["\u003cp\u003eA single-use transaction, limited to one read, can only be used with one \u003ccode\u003eRead()\u003c/code\u003e or \u003ccode\u003eExecuteQuery()\u003c/code\u003e call.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eSingleUseOptions\u003c/code\u003e has 3 constructors: one for \u003ccode\u003eReadOnlyOptions\u003c/code\u003e, one for \u003ccode\u003eTimestamp\u003c/code\u003e and another for \u003ccode\u003estd::chrono::nanoseconds\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eSingleUseOptions\u003c/code\u003e are not able to build an application-level \u003ccode\u003eTransaction\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Class SingleUseOptions (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_1Transaction_1_1SingleUseOptions)\n- [2.41.0](/cpp/docs/reference/spanner/2.41.0/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions)\n- [2.40.0](/cpp/docs/reference/spanner/2.40.0/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions)\n- [2.39.0](/cpp/docs/reference/spanner/2.39.0/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions)\n- [2.38.0](/cpp/docs/reference/spanner/2.38.0/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions)\n- [2.37.0](/cpp/docs/reference/spanner/2.37.0/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions)\n- [2.36.0](/cpp/docs/reference/spanner/2.36.0/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions)\n- [2.35.0](/cpp/docs/reference/spanner/2.35.0/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions)\n- [2.34.0](/cpp/docs/reference/spanner/2.34.0/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions)\n- [2.33.0](/cpp/docs/reference/spanner/2.33.0/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions)\n- [2.32.0](/cpp/docs/reference/spanner/2.32.0/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions)\n- [2.31.0](/cpp/docs/reference/spanner/2.31.0/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions)\n- [2.30.0](/cpp/docs/reference/spanner/2.30.0/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions)\n- [2.29.0](/cpp/docs/reference/spanner/2.29.0/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions)\n- [2.28.0](/cpp/docs/reference/spanner/2.28.0/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions)\n- [2.27.0](/cpp/docs/reference/spanner/2.27.0/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions)\n- [2.26.0](/cpp/docs/reference/spanner/2.26.0/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions)\n- [2.25.1](/cpp/docs/reference/spanner/2.25.1/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions)\n- [2.24.0](/cpp/docs/reference/spanner/2.24.0/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions)\n- [2.23.0](/cpp/docs/reference/spanner/2.23.0/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions)\n- [2.22.1](/cpp/docs/reference/spanner/2.22.1/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions)\n- [2.21.0](/cpp/docs/reference/spanner/2.21.0/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions)\n- [2.20.0](/cpp/docs/reference/spanner/2.20.0/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions)\n- [2.19.0](/cpp/docs/reference/spanner/2.19.0/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions)\n- [2.18.0](/cpp/docs/reference/spanner/2.18.0/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions)\n- [2.17.0](/cpp/docs/reference/spanner/2.17.0/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions)\n- [2.16.0](/cpp/docs/reference/spanner/2.16.0/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions)\n- [2.15.1](/cpp/docs/reference/spanner/2.15.1/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions)\n- [2.14.0](/cpp/docs/reference/spanner/2.14.0/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions)\n- [2.13.0](/cpp/docs/reference/spanner/2.13.0/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions)\n- [2.12.0](/cpp/docs/reference/spanner/2.12.0/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions)\n- [2.11.0](/cpp/docs/reference/spanner/2.11.0/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions) \n[Options](https://cloud.google.com/cpp/docs/reference/common/latest/classgoogle_1_1cloud_1_1Options.html) for \"single-use\", ReadOnly transactions, where Spanner chooses the read timestamp, subject to user-provided bounds. \nThis allows reading without blocking.\n\nBecause selection of the timestamp requires knowledge of which rows will be read, a single-use transaction can only be used with one read. See [`Client::Read()`](/cpp/docs/reference/spanner/latest/classgoogle_1_1cloud_1_1spanner_1_1Client#classgoogle_1_1cloud_1_1spanner_1_1Client_1a167955c44cd3ccb46ffe07cad6e7e52b) and [`Client::ExecuteQuery()`](/cpp/docs/reference/spanner/latest/classgoogle_1_1cloud_1_1spanner_1_1Client#classgoogle_1_1cloud_1_1spanner_1_1Client_1a8e2afee42f535c0436d9161c54b84179). [SingleUseOptions](/cpp/docs/reference/spanner/latest/classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions#classgoogle_1_1cloud_1_1spanner_1_1Transaction_1_1SingleUseOptions) cannot be used to construct an application-level [Transaction](/cpp/docs/reference/spanner/latest/classgoogle_1_1cloud_1_1spanner_1_1Transaction).\n\nConstructors\n------------\n\n### SingleUseOptions(ReadOnlyOptions)\n\n### SingleUseOptions(Timestamp)\n\n### SingleUseOptions(std::chrono::nanoseconds)"]]
