Permalink
Browse files

Small improvement to docs/model-api.txt

git-svn-id: http://code.djangoproject.com/svn/django/trunk@1306 bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
1 parent 2bb18ed commit c472b1471d662b3a3f35641b83086622eae3c10e @adrianholovaty adrianholovaty committed Nov 20, 2005
Showing with 10 additions and 2 deletions.
  1. +10 −2 docs/model-api.txt
View
@@ -1079,9 +1079,17 @@ the resulting rows. Example::
row = cursor.fetchone()
return row
-Note that ``db`` and ``cursor`` simply use the standard `Python DB-API`_.
+If your custom SQL statement alters the data in your database -- for example,
+via a ``DELETE``, ``INSERT`` or ``UPDATE`` -- you'll need to call
+``db.commit()``. example::
-If you're not familiar with the Python DB-API, note that the SQL statement in
+ def my_custom_sql2(self):
+ cursor = db.cursor()
+ cursor.execute("DELETE FROM bar WHERE baz = %s", [self.baz])
+ db.commit()
+
+``db`` and ``cursor`` simply use the standard `Python DB-API`_. If you're not
+familiar with the Python DB-API, note that the SQL statement in
``cursor.execute()`` uses placeholders, ``"%s"``, rather than adding parameters
directly within the SQL. If you use this technique, the underlying database
library will automatically add quotes and escaping to your parameter(s) as

0 comments on commit c472b14

Please sign in to comment.