Reference documentation and code samples for the Cloud Spanner V1 Client class Transaction.
A transaction.
Generated from protobuf message google.spanner.v1.Transaction
Namespace
Google \ Cloud \ Spanner \ V1
Methods
__construct
Constructor.
Parameters
Name
Description
data
array
Optional. Data for populating the Message object.
↳ id
string
id may be used to identify the transaction in subsequent Read, ExecuteSql, Commit, or Rollback calls. Single-use read-only transactions do not have IDs, because single-use transactions do not support multiple requests.
For snapshot read-only transactions, the read timestamp chosen for the transaction. Not returned by default: see TransactionOptions.ReadOnly.return_read_timestamp. A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: "2014-10-02T15:01:23.045123456Z".
A precommit token is included in the response of a BeginTransaction request if the read-write transaction is on a multiplexed session and a mutation_key was specified in the BeginTransaction. The precommit token with the highest sequence number from this transaction attempt should be passed to the Commit request for this transaction.
getId
id may be used to identify the transaction in subsequent
Read,
ExecuteSql,
Commit, or
Rollback calls.
Single-use read-only transactions do not have IDs, because
single-use transactions do not support multiple requests.
Returns
Type
Description
string
setId
id may be used to identify the transaction in subsequent
Read,
ExecuteSql,
Commit, or
Rollback calls.
Single-use read-only transactions do not have IDs, because
single-use transactions do not support multiple requests.
Parameter
Name
Description
var
string
Returns
Type
Description
$this
getReadTimestamp
For snapshot read-only transactions, the read timestamp chosen
for the transaction. Not returned by default: see
TransactionOptions.ReadOnly.return_read_timestamp.
A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds.
Example: "2014-10-02T15:01:23.045123456Z".
For snapshot read-only transactions, the read timestamp chosen
for the transaction. Not returned by default: see
TransactionOptions.ReadOnly.return_read_timestamp.
A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds.
Example: "2014-10-02T15:01:23.045123456Z".
A precommit token is included in the response of a BeginTransaction
request if the read-write transaction is on a multiplexed session and
a mutation_key was specified in the
BeginTransaction.
The precommit token with the highest sequence number from this transaction
attempt should be passed to the Commit
request for this transaction.
A precommit token is included in the response of a BeginTransaction
request if the read-write transaction is on a multiplexed session and
a mutation_key was specified in the
BeginTransaction.
The precommit token with the highest sequence number from this transaction
attempt should be passed to the Commit
request for this 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-09-04 UTC."],[],[],null,["# Cloud Spanner V1 Client - Class Transaction (1.104.0)\n\nVersion latestkeyboard_arrow_down\n\n- [1.104.0 (latest)](/php/docs/reference/cloud-spanner/latest/V1.Transaction)\n- [1.103.0](/php/docs/reference/cloud-spanner/1.103.0/V1.Transaction)\n- [1.102.0](/php/docs/reference/cloud-spanner/1.102.0/V1.Transaction)\n- [1.101.0](/php/docs/reference/cloud-spanner/1.101.0/V1.Transaction)\n- [1.100.0](/php/docs/reference/cloud-spanner/1.100.0/V1.Transaction)\n- [1.98.0](/php/docs/reference/cloud-spanner/1.98.0/V1.Transaction)\n- [1.97.0](/php/docs/reference/cloud-spanner/1.97.0/V1.Transaction)\n- [1.96.0](/php/docs/reference/cloud-spanner/1.96.0/V1.Transaction)\n- [1.95.0](/php/docs/reference/cloud-spanner/1.95.0/V1.Transaction)\n- [1.94.0](/php/docs/reference/cloud-spanner/1.94.0/V1.Transaction)\n- [1.93.1](/php/docs/reference/cloud-spanner/1.93.1/V1.Transaction)\n- [1.92.1](/php/docs/reference/cloud-spanner/1.92.1/V1.Transaction)\n- [1.91.0](/php/docs/reference/cloud-spanner/1.91.0/V1.Transaction)\n- [1.90.0](/php/docs/reference/cloud-spanner/1.90.0/V1.Transaction)\n- [1.89.0](/php/docs/reference/cloud-spanner/1.89.0/V1.Transaction)\n- [1.88.0](/php/docs/reference/cloud-spanner/1.88.0/V1.Transaction)\n- [1.87.0](/php/docs/reference/cloud-spanner/1.87.0/V1.Transaction)\n- [1.86.0](/php/docs/reference/cloud-spanner/1.86.0/V1.Transaction)\n- [1.85.0](/php/docs/reference/cloud-spanner/1.85.0/V1.Transaction)\n- [1.84.0](/php/docs/reference/cloud-spanner/1.84.0/V1.Transaction)\n- [1.83.0](/php/docs/reference/cloud-spanner/1.83.0/V1.Transaction)\n- [1.82.0](/php/docs/reference/cloud-spanner/1.82.0/V1.Transaction)\n- [1.81.0](/php/docs/reference/cloud-spanner/1.81.0/V1.Transaction)\n- [1.80.0](/php/docs/reference/cloud-spanner/1.80.0/V1.Transaction)\n- [1.79.0](/php/docs/reference/cloud-spanner/1.79.0/V1.Transaction)\n- [1.78.0](/php/docs/reference/cloud-spanner/1.78.0/V1.Transaction)\n- [1.77.0](/php/docs/reference/cloud-spanner/1.77.0/V1.Transaction)\n- [1.76.1](/php/docs/reference/cloud-spanner/1.76.1/V1.Transaction)\n- [1.68.0](/php/docs/reference/cloud-spanner/1.68.0/V1.Transaction)\n- [1.67.0](/php/docs/reference/cloud-spanner/1.67.0/V1.Transaction)\n- [1.66.0](/php/docs/reference/cloud-spanner/1.66.0/V1.Transaction)\n- [1.65.0](/php/docs/reference/cloud-spanner/1.65.0/V1.Transaction)\n- [1.64.0](/php/docs/reference/cloud-spanner/1.64.0/V1.Transaction)\n- [1.63.2](/php/docs/reference/cloud-spanner/1.63.2/V1.Transaction)\n- [1.62.1](/php/docs/reference/cloud-spanner/1.62.1/V1.Transaction)\n- [1.61.0](/php/docs/reference/cloud-spanner/1.61.0/V1.Transaction)\n- [1.60.0](/php/docs/reference/cloud-spanner/1.60.0/V1.Transaction)\n- [1.59.0](/php/docs/reference/cloud-spanner/1.59.0/V1.Transaction)\n- [1.58.4](/php/docs/reference/cloud-spanner/1.58.4/V1.Transaction)\n- [1.57.0](/php/docs/reference/cloud-spanner/1.57.0/V1.Transaction)\n- [1.56.0](/php/docs/reference/cloud-spanner/1.56.0/V1.Transaction)\n- [1.55.0](/php/docs/reference/cloud-spanner/1.55.0/V1.Transaction)\n- [1.54.2](/php/docs/reference/cloud-spanner/1.54.2/V1.Transaction) \nReference documentation and code samples for the Cloud Spanner V1 Client class Transaction.\n\nA transaction.\n\nGenerated from protobuf message `google.spanner.v1.Transaction`\n\nNamespace\n---------\n\nGoogle \\\\ Cloud \\\\ Spanner \\\\ V1\n\nMethods\n-------\n\n### __construct\n\nConstructor.\n\n### getId\n\n`id` may be used to identify the transaction in subsequent\nRead,\nExecuteSql,\nCommit, or\nRollback calls.\n\nSingle-use read-only transactions do not have IDs, because\nsingle-use transactions do not support multiple requests.\n\n### setId\n\n`id` may be used to identify the transaction in subsequent\nRead,\nExecuteSql,\nCommit, or\nRollback calls.\n\nSingle-use read-only transactions do not have IDs, because\nsingle-use transactions do not support multiple requests.\n\n### getReadTimestamp\n\nFor snapshot read-only transactions, the read timestamp chosen\nfor the transaction. Not returned by default: see\nTransactionOptions.ReadOnly.return_read_timestamp.\n\nA timestamp in RFC3339 UTC \"Zulu\" format, accurate to nanoseconds.\nExample: `\"2014-10-02T15:01:23.045123456Z\"`.\n\n### hasReadTimestamp\n\n### clearReadTimestamp\n\n### setReadTimestamp\n\nFor snapshot read-only transactions, the read timestamp chosen\nfor the transaction. Not returned by default: see\nTransactionOptions.ReadOnly.return_read_timestamp.\n\nA timestamp in RFC3339 UTC \"Zulu\" format, accurate to nanoseconds.\nExample: `\"2014-10-02T15:01:23.045123456Z\"`.\n\n### getPrecommitToken\n\nA precommit token is included in the response of a BeginTransaction\nrequest if the read-write transaction is on a multiplexed session and\na mutation_key was specified in the\n[BeginTransaction](/php/docs/reference/cloud-spanner/latest/V1.BeginTransactionRequest).\n\nThe precommit token with the highest sequence number from this transaction\nattempt should be passed to the Commit\nrequest for this transaction.\n\n### hasPrecommitToken\n\n### clearPrecommitToken\n\n### setPrecommitToken\n\nA precommit token is included in the response of a BeginTransaction\nrequest if the read-write transaction is on a multiplexed session and\na mutation_key was specified in the\n[BeginTransaction](/php/docs/reference/cloud-spanner/latest/V1.BeginTransactionRequest).\n\nThe precommit token with the highest sequence number from this transaction\nattempt should be passed to the Commit\nrequest for this transaction."]]