feat(spanner): add a sample for max commit delays

samples/max-commit-delay.js

@@ -0,0 +1,80 @@
+// Copyright 2024 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.
+// sample-metadata:
+//  title: Executes request with max commit delay
+//  usage: node max-commit-delay.js <INSTANCE_ID> <DATABASE_ID> <PROJECT_ID>
+
+'use strict';
+
+function main(
+  instanceId = 'my-instance',
+  databaseId = 'my-database',
+  projectId = 'my-project-id'
+) {
+  // [START spanner_set_max_commit_delay]
+  // Imports the Google Cloud client library.
+  const {Spanner, protos} = require('@google-cloud/spanner');
+
+  /**
+   * TODO(developer): Uncomment the following lines before running the sample.
+   */
+  // const projectId = 'my-project-id';
+  // const instanceId = 'my-instance';
+  // const databaseId = 'my-database';
+
+  // Creates a client.
+  const spanner = new Spanner({
+    projectId: projectId,
+  });
+
+  async function spannerSetMaxCommitDelay() {
+    // Gets a reference to a Cloud Spanner instance and database.
+    const instance = spanner.instance(instanceId);
+    const database = instance.database(databaseId);
+
+    // Instantiate Spanner table objects.
+    const albumsTable = database.table('Albums');
+
+    // Updates rows in the Venues table.
+    try {
+      const [response] = await albumsTable.upsert(
+        [
+          {SingerId: '1', AlbumId: '1', MarketingBudget: '200000'},
+          {SingerId: '2', AlbumId: '2', MarketingBudget: '400000'},
+        ],
+        {
+          maxCommitDelay: protos.google.protobuf.Duration({
+            seconds: 0, // 0 seconds
+            nanos: 100000000, // 100,000,000 nanoseconds = 100 milliseconds
+          }),
+        }
+      );
+      console.log(
+        `Updated data with ${response.commitStats.mutationCount} mutations.`
+      );
+    } catch (err) {
+      console.error('ERROR:', err);
+    } finally {
+      // Close the database when finished.
+      database.close();
+    }
+  }
+  spannerSetMaxCommitDelay();
+  // [END spanner_set_max_commit_delay]
+}
+process.on('unhandledRejection', err => {
+  console.error(err.message);
+  process.exitCode = 1;
+});
+main(...process.argv.slice(2));

samples/system-test/spanner.test.js

@@ -1353,6 +1353,14 @@ describe('Spanner', () => {
     assert.match(output, new RegExp('Updated data with (\\d+) mutations'));
   });
 
+  // set_max_commit_delay
+  it('should update rows in Albums example table and set max commit delay', async () => {
+    const output = execSync(
+      `${crudCmd} setMaxCommitDelay ${INSTANCE_ID} ${DATABASE_ID} ${PROJECT_ID}`
+    );
+    assert.match(output, new RegExp('Updated data with (\\d+) mutations'));
+  });
+
   // create_database_with_version_retention_period
   it('should create a database with a version retention period', async () => {
     const output = execSync(