[Python-checkins] r83749 - python/branches/release27-maint/Doc/library/sqlite3.rst

[gerhard.haering]

Author: gerhard.haering
Date: Fri Aug  6 08:14:12 2010
New Revision: 83749

Log:
Issue #3854: Documented using the sqlite3 module with multiple threads.


Modified:
   python/branches/release27-maint/Doc/library/sqlite3.rst

Modified: python/branches/release27-maint/Doc/library/sqlite3.rst
==============================================================================
--- python/branches/release27-maint/Doc/library/sqlite3.rst	(original)
+++ python/branches/release27-maint/Doc/library/sqlite3.rst	Fri Aug  6 08:14:12 2010
@@ -880,3 +880,18 @@
 committed:
 
 .. literalinclude:: ../includes/sqlite3/ctx_manager.py
+
+
+Common issues
+-------------
+
+Multithreading
+^^^^^^^^^^^^^^
+
+Older SQLite versions had issues with sharing connections between threads.
+That's why the Python module disallows sharing connections and cursors between
+threads. If you still try to do so, you will get an exception at runtime.
+
+The only exception is calling the :meth:`~Connection.interrupt` method, which
+only makes sense to call from a different thread.
+