Cloud Spanner V1 Client - Class CommitRequest (1.87.0)

Version 1.87.0

• 1.89.0 (latest)
• 1.88.0
• 1.87.0
• 1.86.0
• 1.85.0
• 1.84.0
• 1.83.0
• 1.82.0
• 1.81.0
• 1.80.0
• 1.79.0
• 1.78.0
• 1.77.0
• 1.76.1
• 1.68.0
• 1.67.0
• 1.66.0
• 1.65.0
• 1.64.0
• 1.63.2
• 1.62.1
• 1.61.0
• 1.60.0
• 1.59.0
• 1.58.4
• 1.57.0
• 1.56.0
• 1.55.0
• 1.54.2

Reference documentation and code samples for the Cloud Spanner V1 Client class CommitRequest.

The request for Commit.

Generated from protobuf message google.spanner.v1.CommitRequest

Namespace

Google \ Cloud \ Spanner \ V1

Methods

__construct

Constructor.

Parameters
Name	Description
data	array Optional. Data for populating the Message object.
↳ session	string Required. The session in which the transaction to be committed is running.
↳ transaction_id	string Commit a previously-started transaction.
↳ single_use_transaction	Google\Cloud\Spanner\V1\TransactionOptions Execute mutations in a temporary transaction. Note that unlike commit of a previously-started transaction, commit with a temporary transaction is non-idempotent. That is, if the CommitRequest is sent to Cloud Spanner more than once (for instance, due to retries in the application, or in the transport library), it is possible that the mutations are executed more than once. If this is undesirable, use BeginTransaction and Commit instead.
↳ mutations	array<Google\Cloud\Spanner\V1\Mutation> The mutations to be executed when this transaction commits. All mutations are applied atomically, in the order they appear in this list.
↳ return_commit_stats	bool If true, then statistics related to the transaction will be included in the CommitResponse. Default value is false.
↳ max_commit_delay	Google\Protobuf\Duration Optional. The amount of latency this request is willing to incur in order to improve throughput. If this field is not set, Spanner assumes requests are relatively latency sensitive and automatically determines an appropriate delay time. You can specify a batching delay value between 0 and 500 ms.
↳ request_options	Google\Cloud\Spanner\V1\RequestOptions Common options for this request.
↳ precommit_token	Google\Cloud\Spanner\V1\MultiplexedSessionPrecommitToken Optional. If the read-write transaction was executed on a multiplexed session, the precommit token with the highest sequence number received in this transaction attempt, should be included here. Failing to do so will result in a FailedPrecondition error. This feature is not yet supported and will result in an UNIMPLEMENTED error.

getSession

Required. The session in which the transaction to be committed is running.

Returns
Type	Description
string

setSession

Required. The session in which the transaction to be committed is running.

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getTransactionId

Commit a previously-started transaction.

Returns
Type	Description
string

hasTransactionId

setTransactionId

Commit a previously-started transaction.

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getSingleUseTransaction

Execute mutations in a temporary transaction. Note that unlike commit of a previously-started transaction, commit with a temporary transaction is non-idempotent. That is, if the CommitRequest is sent to Cloud Spanner more than once (for instance, due to retries in the application, or in the transport library), it is possible that the mutations are executed more than once. If this is undesirable, use BeginTransaction and Commit instead.

Returns
Type	Description
Google\Cloud\Spanner\V1\TransactionOptions|null

hasSingleUseTransaction

setSingleUseTransaction

Execute mutations in a temporary transaction. Note that unlike commit of a previously-started transaction, commit with a temporary transaction is non-idempotent. That is, if the CommitRequest is sent to Cloud Spanner more than once (for instance, due to retries in the application, or in the transport library), it is possible that the mutations are executed more than once. If this is undesirable, use BeginTransaction and Commit instead.

Parameter
Name	Description
var	Google\Cloud\Spanner\V1\TransactionOptions

Returns
Type	Description
$this

getMutations

The mutations to be executed when this transaction commits. All mutations are applied atomically, in the order they appear in this list.

Returns
Type	Description
Google\Protobuf\Internal\RepeatedField

setMutations

The mutations to be executed when this transaction commits. All mutations are applied atomically, in the order they appear in this list.

Parameter
Name	Description
var	array<Google\Cloud\Spanner\V1\Mutation>

Returns
Type	Description
$this

getReturnCommitStats

If true, then statistics related to the transaction will be included in the CommitResponse.

Default value is false.

Returns
Type	Description
bool

setReturnCommitStats

If true, then statistics related to the transaction will be included in the CommitResponse.

Default value is false.

Parameter
Name	Description
var	bool

Returns
Type	Description
$this

getMaxCommitDelay

Optional. The amount of latency this request is willing to incur in order to improve throughput. If this field is not set, Spanner assumes requests are relatively latency sensitive and automatically determines an appropriate delay time. You can specify a batching delay value between 0 and 500 ms.

Returns
Type	Description
Google\Protobuf\Duration|null

hasMaxCommitDelay

clearMaxCommitDelay

setMaxCommitDelay

Optional. The amount of latency this request is willing to incur in order to improve throughput. If this field is not set, Spanner assumes requests are relatively latency sensitive and automatically determines an appropriate delay time. You can specify a batching delay value between 0 and 500 ms.

Parameter
Name	Description
var	Google\Protobuf\Duration

Returns
Type	Description
$this

getRequestOptions

Common options for this request.

Returns
Type	Description
Google\Cloud\Spanner\V1\RequestOptions|null

hasRequestOptions

clearRequestOptions

setRequestOptions

Common options for this request.

Parameter
Name	Description
var	Google\Cloud\Spanner\V1\RequestOptions

Returns
Type	Description
$this

getPrecommitToken

Optional. If the read-write transaction was executed on a multiplexed session, the precommit token with the highest sequence number received in this transaction attempt, should be included here. Failing to do so will result in a FailedPrecondition error.

This feature is not yet supported and will result in an UNIMPLEMENTED error.

Returns
Type	Description
Google\Cloud\Spanner\V1\MultiplexedSessionPrecommitToken|null

hasPrecommitToken

clearPrecommitToken

setPrecommitToken

Optional. If the read-write transaction was executed on a multiplexed session, the precommit token with the highest sequence number received in this transaction attempt, should be included here. Failing to do so will result in a FailedPrecondition error.

This feature is not yet supported and will result in an UNIMPLEMENTED error.

Parameter
Name	Description
var	Google\Cloud\Spanner\V1\MultiplexedSessionPrecommitToken

Returns
Type	Description
$this

getTransaction

Returns
Type	Description
string

static::build

Parameters
Name	Description
session	string Required. The session in which the transaction to be committed is running. Please see Google\Cloud\Spanner\V1\SpannerClient::sessionName() for help formatting this field.
transactionId	string Commit a previously-started transaction.
mutations	array<Google\Cloud\Spanner\V1\Mutation> The mutations to be executed when this transaction commits. All mutations are applied atomically, in the order they appear in this list.

Returns
Type	Description
Google\Cloud\Spanner\V1\CommitRequest

static::buildFromSessionSingleUseTransactionMutations

Parameters
Name	Description
session	string Required. The session in which the transaction to be committed is running. Please see Google\Cloud\Spanner\V1\SpannerClient::sessionName() for help formatting this field.
singleUseTransaction	Google\Cloud\Spanner\V1\TransactionOptions Execute mutations in a temporary transaction. Note that unlike commit of a previously-started transaction, commit with a temporary transaction is non-idempotent. That is, if the CommitRequest is sent to Cloud Spanner more than once (for instance, due to retries in the application, or in the transport library), it is possible that the mutations are executed more than once. If this is undesirable, use BeginTransaction and Commit instead.
mutations	array<Google\Cloud\Spanner\V1\Mutation> The mutations to be executed when this transaction commits. All mutations are applied atomically, in the order they appear in this list.

Returns
Type	Description
Google\Cloud\Spanner\V1\CommitRequest