From 8441edcc161a5ad86f171dfc2cd4b9ccef19b2c0 Mon Sep 17 00:00:00 2001
From: HemangChothani <50404902+HemangChothani@users.noreply.github.com>
Date: Fri, 29 Jan 2021 13:49:04 -0500
Subject: [PATCH] fix: add description for transaction autocommit (#587)

---
 django_spanner/base.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/django_spanner/base.py b/django_spanner/base.py
index cac9abd315..9b0824a25c 100644
--- a/django_spanner/base.py
+++ b/django_spanner/base.py
@@ -199,6 +199,10 @@ def is_usable(self):
 
         return True
 
+    # The usual way to start a transaction is to turn autocommit off.
+    # Spanner DB API does not properly start a transaction when disabling
+    # autocommit. To avoid this buggy behavior and to actually enter a new
+    # transaction, an explicit SELECT 1 is required.
     def _start_transaction_under_autocommit(self):
         """
         Start a transaction explicitly in autocommit mode.