feat: Add the last statement option to ExecuteSqlRequest and ExecuteB…

…atchDmlRequest (googleapis#2196)

* feat: Add the last statement option to ExecuteSqlRequest and ExecuteBatchDmlRequest

PiperOrigin-RevId: 699218836

Source-Link: googleapis/googleapis@97da65f

Source-Link: https://github.com/googleapis/googleapis-gen/commit/d134e8da8048393b019da39866976d2c413ac5e1
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiZDEzNGU4ZGE4MDQ4MzkzYjAxOWRhMzk4NjY5NzZkMmM0MTNhYzVlMSJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

protos/google/spanner/v1/spanner.proto

@@ -792,6 +792,17 @@ message ExecuteSqlRequest {
   // If the field is set to `true` but the request does not set
   // `partition_token`, the API returns an `INVALID_ARGUMENT` error.
   bool data_boost_enabled = 16;
+
+  // Optional. If set to true, this statement marks the end of the transaction.
+  // The transaction should be committed or aborted after this statement
+  // executes, and attempts to execute any other requests against this
+  // transaction (including reads and queries) will be rejected.
+  //
+  // For DML statements, setting this option may cause some error reporting to
+  // be deferred until commit time (e.g. validation of unique constraints).
+  // Given this, successful execution of a DML statement should not be assumed
+  // until a subsequent Commit call completes successfully.
+  bool last_statement = 17 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // The request for [ExecuteBatchDml][google.spanner.v1.Spanner.ExecuteBatchDml].
@@ -861,6 +872,17 @@ message ExecuteBatchDmlRequest {
 
   // Common options for this request.
   RequestOptions request_options = 5;
+
+  // Optional. If set to true, this request marks the end of the transaction.
+  // The transaction should be committed or aborted after these statements
+  // execute, and attempts to execute any other requests against this
+  // transaction (including reads and queries) will be rejected.
+  //
+  // Setting this option may cause some error reporting to be deferred until
+  // commit time (e.g. validation of unique constraints). Given this, successful
+  // execution of statements should not be assumed until a subsequent Commit
+  // call completes successfully.
+  bool last_statements = 6 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // The response for

src/v1/spanner_client.ts

@@ -895,6 +895,16 @@ export class SpannerClient {
    *
    *   If the field is set to `true` but the request does not set
    *   `partition_token`, the API returns an `INVALID_ARGUMENT` error.
+   * @param {boolean} [request.lastStatement]
+   *   Optional. If set to true, this statement marks the end of the transaction.
+   *   The transaction should be committed or aborted after this statement
+   *   executes, and attempts to execute any other requests against this
+   *   transaction (including reads and queries) will be rejected.
+   *
+   *   For DML statements, setting this option may cause some error reporting to
+   *   be deferred until commit time (e.g. validation of unique constraints).
+   *   Given this, successful execution of a DML statement should not be assumed
+   *   until a subsequent Commit call completes successfully.
    * @param {object} [options]
    *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
    * @returns {Promise} - The promise which resolves to an array.
@@ -1010,6 +1020,16 @@ export class SpannerClient {
    *   handled requests will yield the same response as the first execution.
    * @param {google.spanner.v1.RequestOptions} request.requestOptions
    *   Common options for this request.
+   * @param {boolean} [request.lastStatements]
+   *   Optional. If set to true, this request marks the end of the transaction.
+   *   The transaction should be committed or aborted after these statements
+   *   execute, and attempts to execute any other requests against this
+   *   transaction (including reads and queries) will be rejected.
+   *
+   *   Setting this option may cause some error reporting to be deferred until
+   *   commit time (e.g. validation of unique constraints). Given this, successful
+   *   execution of statements should not be assumed until a subsequent Commit
+   *   call completes successfully.
    * @param {object} [options]
    *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
    * @returns {Promise} - The promise which resolves to an array.
@@ -1906,6 +1926,16 @@ export class SpannerClient {
    *
    *   If the field is set to `true` but the request does not set
    *   `partition_token`, the API returns an `INVALID_ARGUMENT` error.
+   * @param {boolean} [request.lastStatement]
+   *   Optional. If set to true, this statement marks the end of the transaction.
+   *   The transaction should be committed or aborted after this statement
+   *   executes, and attempts to execute any other requests against this
+   *   transaction (including reads and queries) will be rejected.
+   *
+   *   For DML statements, setting this option may cause some error reporting to
+   *   be deferred until commit time (e.g. validation of unique constraints).
+   *   Given this, successful execution of a DML statement should not be assumed
+   *   until a subsequent Commit call completes successfully.
    * @param {object} [options]
    *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
    * @returns {Stream}