Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse code

[1.4.X] Added documentation notes about lack of database savepoints s…

…upport when using MySQL+MyISAM.

Refs #15507 and r17341.

Backport of r17923.

git-svn-id: http://code.djangoproject.com/svn/django/branches/releases/1.4.X@17924 bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
commit 839a71b0a586b1c274546ac3ed8e599be8db10b9 1 parent 1433051
Ramiro Morales authored April 21, 2012

Showing 1 changed file with 17 additions and 0 deletions. Show diff stats Hide diff stats

  1. 17  docs/ref/databases.txt
17  docs/ref/databases.txt
@@ -148,6 +148,8 @@ procedures, but Django currently doesn't use stored procedures.
148 148
 .. _MySQL 4.1: http://dev.mysql.com/doc/refman/4.1/en/index.html
149 149
 .. _MySQL 5.0: http://dev.mysql.com/doc/refman/5.0/en/index.html
150 150
 
  151
+.. _mysql-storage-engines:
  152
+
151 153
 Storage engines
152 154
 ---------------
153 155
 
@@ -360,6 +362,21 @@ via the :class:`~django.db.models.Options.db_table` parameter.
360 362
 
361 363
 .. _known issues: http://bugs.mysql.com/bug.php?id=48875
362 364
 
  365
+Savepoints
  366
+----------
  367
+
  368
+Both the Django ORM and MySQL (when using the InnoDB :ref:`storage engine
  369
+<mysql-storage-engines>`) support database :ref:`savepoints
  370
+<topics-db-transactions-savepoints>`, but this feature wasn't available in
  371
+Django until version 1.4 when such supports was added.
  372
+
  373
+If you use the MyISAM storage engine please be aware of the fact that you will
  374
+receive database-generated errors if you try to use the :ref:`savepoint-related
  375
+methods of the transactions API <topics-db-transactions-savepoints>`. The reason
  376
+for this is that detecting the storage engine of a MySQL database/table is an
  377
+expensive operation so it was decided it isn't worth to dynamically convert
  378
+these methods in no-op's based in the results of such detection.
  379
+
363 380
 Notes on specific fields
364 381
 ------------------------
365 382
 

0 notes on commit 839a71b

Please sign in to comment.
Something went wrong with that request. Please try again.