docs: Add documentation for using DML statements in a transaction (googleapis#44)

larkee · web-flow · commit 13a9027ee66c · 2020-03-24T15:03:43.000+11:00
Co-authored-by: larkee &lt;larkee@users.noreply.github.com&gt;
diff --git a/docs/transaction-usage.rst b/docs/transaction-usage.rst
@@ -51,6 +51,18 @@ fails if the result set is too large,
         print(row)
 
 
+Execute a SQL DML Statement
+------------------------------
+
+Modify data from a query against tables in the database.  Calls
+the ``ExecuteSql`` API, and returns the number of rows affected,
+
+.. code:: python
+
+    QUERY = 'DELETE from Table WHERE 1=1'
+    row_count = transaction.execute_sql(QUERY)
+
+
 Insert records using a Transaction
 ----------------------------------
 
