Cloud Spanner V1 Client - Class CommitRequest (1.67.0)

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
NameDescription
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.

↳ request_options Google\Cloud\Spanner\V1\RequestOptions

Common options for this request.

getSession

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

Returns
TypeDescription
string

setSession

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

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getTransactionId

Commit a previously-started transaction.

Returns
TypeDescription
string

hasTransactionId

setTransactionId

Commit a previously-started transaction.

Parameter
NameDescription
var string
Returns
TypeDescription
$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
TypeDescription
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
NameDescription
var Google\Cloud\Spanner\V1\TransactionOptions
Returns
TypeDescription
$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
TypeDescription
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
NameDescription
var array<Google\Cloud\Spanner\V1\Mutation>
Returns
TypeDescription
$this

getReturnCommitStats

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

Default value is false.

Returns
TypeDescription
bool

setReturnCommitStats

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

Default value is false.

Parameter
NameDescription
var bool
Returns
TypeDescription
$this

getRequestOptions

Common options for this request.

Returns
TypeDescription
Google\Cloud\Spanner\V1\RequestOptions|null

hasRequestOptions

clearRequestOptions

setRequestOptions

Common options for this request.

Parameter
NameDescription
var Google\Cloud\Spanner\V1\RequestOptions
Returns
TypeDescription
$this

getTransaction

Returns
TypeDescription
string

static::build

Parameters
NameDescription
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
TypeDescription
Google\Cloud\Spanner\V1\CommitRequest

static::buildFromSessionSingleUseTransactionMutations

Parameters
NameDescription
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
TypeDescription
Google\Cloud\Spanner\V1\CommitRequest