feat: Update TransactionOptions to include new option exclude_txn_from_change_streams

Google APIs · copybara-github · commit d8af2d65a80f · 2024-02-16T14:50:06.000-08:00
PiperOrigin-RevId: 607807587
diff --git a/google/spanner/v1/transaction.proto b/google/spanner/v1/transaction.proto
@@ -1,4 +1,4 @@
-// Copyright 2022 Google LLC
+// Copyright 2023 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -475,6 +475,22 @@ message TransactionOptions {
     // on the `session` resource.
     ReadOnly read_only = 2;
   }
+
+  // When `exclude_txn_from_change_streams` is set to `true`:
+  //  * Mutations from this transaction will not be recorded in change streams
+  //  with DDL option `allow_txn_exclusion=true` that are tracking columns
+  //  modified by these transactions.
+  //  * Mutations from this transaction will be recorded in change streams with
+  //  DDL option `allow_txn_exclusion=false or not set` that are tracking
+  //  columns modified by these transactions.
+  //
+  // When `exclude_txn_from_change_streams` is set to `false` or not set,
+  // mutations from this transaction will be recorded in all change streams that
+  // are tracking columns modified by these transactions.
+  // `exclude_txn_from_change_streams` may only be specified for read-write or
+  // partitioned-dml transactions, otherwise the API will return an
+  // `INVALID_ARGUMENT` error.
+  bool exclude_txn_from_change_streams = 5;
 }
 
 // A transaction.
