chore: snapshot isolation sample

Author: surbhigarg92

samples/samples/requirements.txt

@@ -1,2 +1,2 @@
-google-cloud-spanner==3.50.0
+google-cloud-spanner==3.53.0
 futures==3.4.0; python_version < "3"

samples/samples/snippets.py

@@ -3118,6 +3118,42 @@ def directed_read_options(
             print("SingerId: {}, AlbumId: {}, AlbumTitle: {}".format(*row))
     # [END spanner_directed_read]
 
+def isolation_level_options(
+    instance_id,
+    database_id,
+):
+    from google.cloud.spanner_v1 import TransactionOptions, DefaultTransactionOptions
+    
+    """
+    Shows how to run a Read Write transaction with isolation level options.
+    """
+    # [START spanner_isolation_level]
+    # instance_id = "your-spanner-instance"
+    # database_id = "your-spanner-db-id"
+
+    isolation_level_options_for_client = TransactionOptions.IsolationLevel.SERIALIZABLE
+
+    # The isolation level specified at the client level via default_transaction_options will be applied to all RW transactions
+    spanner_client = spanner.Client(
+        default_transaction_options=DefaultTransactionOptions(isolation_level=isolation_level_options_for_client)
+    )
+    instance = spanner_client.instance(instance_id)
+    database = instance.database(database_id)
+
+    isolation_level_options_for_request = TransactionOptions.IsolationLevel.REPEATABLE_READ
+
+    def insert_singers(transaction):
+        row_ct = transaction.execute_update(
+            "INSERT INTO Singers (SingerId, FirstName, LastName) "
+            " VALUES (20, 'Virginia', 'Watson')"
+        )
+
+        print("{} record(s) inserted.".format(row_ct))
+
+    # The isolation level specified at the request level takes precedence over the isolation level configured at the client level.
+    database.run_in_transaction(insert_singers, isolation_level=isolation_level_options_for_request)
+    # [END spanner_isolation_level]
+
 
 def set_custom_timeout_and_retry(instance_id, database_id):
     """Executes a snapshot read with custom timeout and retry."""
@@ -3651,6 +3687,7 @@ def query_data_with_proto_types_parameter(instance_id, database_id):
     )
     enable_fine_grained_access_parser.add_argument("--title", default="condition title")
     subparsers.add_parser("directed_read_options", help=directed_read_options.__doc__)
+    subparsers.add_parser("isolation_level_options", help=isolation_level_options.__doc__)
     subparsers.add_parser(
         "set_custom_timeout_and_retry", help=set_custom_timeout_and_retry.__doc__
     )
@@ -3803,6 +3840,8 @@ def query_data_with_proto_types_parameter(instance_id, database_id):
         )
     elif args.command == "directed_read_options":
         directed_read_options(args.instance_id, args.database_id)
+    elif args.command == "isolation_level_options":
+        isolation_level_options(args.instance_id, args.database_id)
     elif args.command == "set_custom_timeout_and_retry":
         set_custom_timeout_and_retry(args.instance_id, args.database_id)
     elif args.command == "create_instance_with_autoscaling_config":

samples/samples/snippets_test.py

@@ -961,7 +961,11 @@ def test_directed_read_options(capsys, instance_id, sample_database):
     snippets.directed_read_options(instance_id, sample_database.database_id)
     out, _ = capsys.readouterr()
     assert "SingerId: 1, AlbumId: 1, AlbumTitle: Total Junk" in out
-
+    
+def test_isolated_level_options(capsys, instance_id, sample_database):
+    snippets.isolation_level_options(instance_id, sample_database.database_id)
+    out, _ = capsys.readouterr()
+    assert "1 record(s) inserted." in out
 
 @pytest.mark.dependency(depends=["insert_data"])
 def test_set_custom_timeout_and_retry(capsys, instance_id, sample_database):