feat: new transaction options for datastoreV1

Google APIs · copybara-github · commit d4599ad2c237 · 2023-01-13T16:06:16.000-08:00
PiperOrigin-RevId: 501960571
diff --git a/google/datastore/v1/datastore.proto b/google/datastore/v1/datastore.proto
@@ -191,6 +191,13 @@ message LookupResponse {
   // order of the keys in the input.
   repeated Key deferred = 3;
 
+  // The identifier of the transaction that was started as part of this Lookup
+  // request.
+  //
+  // Set only when [ReadOptions.begin_transaction][] was set in
+  // [LookupRequest.read_options][google.datastore.v1.LookupRequest.read_options].
+  bytes transaction = 5;
+
   // The time at which these entities were read or found missing.
   google.protobuf.Timestamp read_time = 7;
 }
@@ -233,6 +240,13 @@ message RunQueryResponse {
 
   // The parsed form of the `GqlQuery` from the request, if it was set.
   Query query = 2;
+
+  // The identifier of the transaction that was started as part of this
+  // RunQuery request.
+  //
+  // Set only when [ReadOptions.begin_transaction][] was set in
+  // [RunQueryRequest.read_options][google.datastore.v1.RunQueryRequest.read_options].
+  bytes transaction = 5;
 }
 
 // The request for
@@ -274,6 +288,13 @@ message RunAggregationQueryResponse {
 
   // The parsed form of the `GqlQuery` from the request, if it was set.
   AggregationQuery query = 2;
+
+  // The identifier of the transaction that was started as part of this
+  // RunAggregationQuery request.
+  //
+  // Set only when [ReadOptions.begin_transaction][] was set in
+  // [RunAggregationQueryRequest.read_options][google.datastore.v1.RunAggregationQueryRequest.read_options].
+  bytes transaction = 5;
 }
 
 // The request for
@@ -354,6 +375,13 @@ message CommitRequest {
     // transaction identifier is returned by a call to
     // [Datastore.BeginTransaction][google.datastore.v1.Datastore.BeginTransaction].
     bytes transaction = 1;
+
+    // Options for beginning a new transaction for this request.
+    // The transaction is committed when the request completes. If specified,
+    // [TransactionOptions.mode][google.datastore.v1.TransactionOptions.mode]
+    // must be
+    // [TransactionOptions.ReadWrite][google.datastore.v1.TransactionOptions.ReadWrite].
+    TransactionOptions single_use_transaction = 10;
   }
 
   // The mutations to perform.
@@ -533,6 +561,15 @@ message ReadOptions {
     // [Datastore.BeginTransaction][google.datastore.v1.Datastore.BeginTransaction].
     bytes transaction = 2;
 
+    // Options for beginning a new transaction for this request.
+    //
+    // The new transaction identifier will be returned in the corresponding
+    // response as either
+    // [LookupResponse.transaction][google.datastore.v1.LookupResponse.transaction]
+    // or
+    // [RunQueryResponse.transaction][google.datastore.v1.RunQueryResponse.transaction].
+    TransactionOptions new_transaction = 3;
+
     // Reads entities as they were at the given time. This may not be older
     // than 270 seconds.  This value is only supported for Cloud Firestore in
     // Datastore mode.
