mirror of
https://github.com/googleapis/googleapis.git
synced 2026-08-17 13:06:47 +02:00
docs(spanner): A comment for field `commit_stats` in message `.google.spanner.v1.CommitResponse` is changed docs(spanner): A comment for field `precommit_token` in message `.google.spanner.v1.CommitResponse` is changed docs(spanner): A comment for message `.google.spanner.v1.TransactionOptions` is changed docs(spanner): A comment for enum value `READ_LOCK_MODE_UNSPECIFIED` in enum `ReadLockMode` is changed docs(spanner): A comment for enum value `PESSIMISTIC` in enum `ReadLockMode` is changed docs(spanner): A comment for enum value `OPTIMISTIC` in enum `ReadLockMode` is changed docs(spanner): A comment for field `multiplexed_session_previous_transaction_id` in message `.google.spanner.v1.TransactionOptions` is changed docs(spanner): A comment for field `exclude_txn_from_change_streams` in message `.google.spanner.v1.TransactionOptions` is changed docs(spanner): A comment for message `.google.spanner.v1.MultiplexedSessionPrecommitToken` is changed PiperOrigin-RevId: 784456709
64 lines
2.7 KiB
Protocol Buffer
64 lines
2.7 KiB
Protocol Buffer
// Copyright 2025 Google LLC
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
syntax = "proto3";
|
|
|
|
package google.spanner.v1;
|
|
|
|
import "google/protobuf/timestamp.proto";
|
|
import "google/spanner/v1/transaction.proto";
|
|
|
|
option csharp_namespace = "Google.Cloud.Spanner.V1";
|
|
option go_package = "cloud.google.com/go/spanner/apiv1/spannerpb;spannerpb";
|
|
option java_multiple_files = true;
|
|
option java_outer_classname = "CommitResponseProto";
|
|
option java_package = "com.google.spanner.v1";
|
|
option php_namespace = "Google\\Cloud\\Spanner\\V1";
|
|
option ruby_package = "Google::Cloud::Spanner::V1";
|
|
|
|
// The response for [Commit][google.spanner.v1.Spanner.Commit].
|
|
message CommitResponse {
|
|
// Additional statistics about a commit.
|
|
message CommitStats {
|
|
// The total number of mutations for the transaction. Knowing the
|
|
// `mutation_count` value can help you maximize the number of mutations
|
|
// in a transaction and minimize the number of API round trips. You can
|
|
// also monitor this value to prevent transactions from exceeding the system
|
|
// [limit](https://cloud.google.com/spanner/quotas#limits_for_creating_reading_updating_and_deleting_data).
|
|
// If the number of mutations exceeds the limit, the server returns
|
|
// [INVALID_ARGUMENT](https://cloud.google.com/spanner/docs/reference/rest/v1/Code#ENUM_VALUES.INVALID_ARGUMENT).
|
|
int64 mutation_count = 1;
|
|
}
|
|
|
|
// The Cloud Spanner timestamp at which the transaction committed.
|
|
google.protobuf.Timestamp commit_timestamp = 1;
|
|
|
|
// The statistics about this `Commit`. Not returned by default.
|
|
// For more information, see
|
|
// [CommitRequest.return_commit_stats][google.spanner.v1.CommitRequest.return_commit_stats].
|
|
CommitStats commit_stats = 2;
|
|
|
|
// You must examine and retry the commit if the following is populated.
|
|
oneof MultiplexedSessionRetry {
|
|
// If specified, transaction has not committed yet.
|
|
// You must retry the commit with the new precommit token.
|
|
MultiplexedSessionPrecommitToken precommit_token = 4;
|
|
}
|
|
|
|
// If `TransactionOptions.isolation_level` is set to
|
|
// `IsolationLevel.REPEATABLE_READ`, then the snapshot timestamp is the
|
|
// timestamp at which all reads in the transaction ran. This timestamp is
|
|
// never returned.
|
|
google.protobuf.Timestamp snapshot_timestamp = 5;
|
|
}
|