Stattdessen wird die Verbindung automatisch dann geschlossen, wenn der Thread
endet. Sie können dieses Verhalten ändern, indem Sie den Parameter namens
closeable setzen.
+
Das Holen einer Verbindung kann etwas beschleunigt werden, indem man den
Parameter threadlocal auf threading.local setzt; dies könnte aber in
einigen Umgebungen nicht funktionieren (es ist zum Beispiel bekannt, dass
@@ -428,12 +431,15 @@
PooledDB (pooled_db)
with db.cursor() as cur:
cur.execute(...)
res = cur.fetchone()
+
diff --git a/docs/main.de.rst b/docs/main.de.rst
index a42853b..ce97364 100644
--- a/docs/main.de.rst
+++ b/docs/main.de.rst
@@ -317,11 +317,12 @@ Stattdessen wird die Verbindung automatisch dann geschlossen, wenn der Thread
endet. Sie können dieses Verhalten ändern, indem Sie den Parameter namens
``closeable`` setzen.
-Bitte beachten Sie, dass Transaktionen explizit durch Aufruf der Methode
-``begin()`` eingeleitet werden müssen. Hierdurch wird sichergestellt, dass
-das transparente Neueröffnen von Verbindungen bis zum Ende der Transaktion
-ausgesetzt wird, und dass die Verbindung zurückgerollt wird, before sie vom
-gleichen Thread erneut benutzt wird.
+.. warning::
+ Bitte beachten Sie, dass Transaktionen explizit durch Aufruf der Methode
+ ``begin()`` eingeleitet werden müssen. Hierdurch wird sichergestellt, dass
+ das transparente Neueröffnen von Verbindungen bis zum Ende der Transaktion
+ ausgesetzt wird, und dass die Verbindung zurückgerollt wird, before sie vom
+ gleichen Thread erneut benutzt wird.
Das Holen einer Verbindung kann etwas beschleunigt werden, indem man den
Parameter ``threadlocal`` auf ``threading.local`` setzt; dies könnte aber in
@@ -452,13 +453,13 @@ Sie können dies auch durch Verwendung von Kontext-Managern vereinfachen::
cur.execute(...)
res = cur.fetchone()
-
-Bitte beachten Sie, dass Transaktionen explizit durch Aufruf der Methode
-``begin()`` eingeleitet werden müssen. Hierdurch wird sichergestellt,
-dass die Verbindung nicht mehr mit anderen Threads geteilt wird, dass das
-transparente Neueröffnen von Verbindungen bis zum Ende der Transaktion
-ausgesetzt wird, und dass die Verbindung zurückgerollt wird, bevor sie
-wieder an den Verbindungspool zurückgegeben wird.
+.. warning::
+ Bitte beachten Sie, dass Transaktionen explizit durch Aufruf der Methode
+ ``begin()`` eingeleitet werden müssen. Hierdurch wird sichergestellt,
+ dass die Verbindung nicht mehr mit anderen Threads geteilt wird, dass das
+ transparente Neueröffnen von Verbindungen bis zum Ende der Transaktion
+ ausgesetzt wird, und dass die Verbindung zurückgerollt wird, bevor sie
+ wieder an den Verbindungspool zurückgegeben wird.
Besonderheiten bei der Benutzung
diff --git a/docs/main.html b/docs/main.html
index 5650867..dede0dc 100644
--- a/docs/main.html
+++ b/docs/main.html
@@ -298,10 +298,13 @@
PersistentDB (persistent_db)
contrary to the intent of having persistent connections. Instead,
the connection will be automatically closed when the thread dies.
You can change this behavior by setting the closeable parameter.
+
By setting the threadlocal parameter to threading.local, getting
connections may become a bit faster, but this may not work in all
environments (for instance, mod_wsgi is known to cause problems
@@ -374,7 +377,7 @@
PooledDB (pooled_db)
db = pool.dedicated_connection()
If you don't need it anymore, you should immediately return it to the
pool with db.close(). You can get another connection in the same way.
-
Warning: In a threaded environment, never do the following:
+
⚠ Warning: In a threaded environment, never do the following:
pool.connection().cursor().execute(...)
This would release the connection too early for reuse which may be fatal
if the connections are not thread-safe. Make sure that the connection
@@ -390,11 +393,14 @@
PooledDB (pooled_db)
with db.cursor() as cur:
cur.execute(...)
res = cur.fetchone()
+
diff --git a/docs/main.rst b/docs/main.rst
index e2fdbd9..816ae80 100644
--- a/docs/main.rst
+++ b/docs/main.rst
@@ -294,10 +294,11 @@ contrary to the intent of having persistent connections. Instead,
the connection will be automatically closed when the thread dies.
You can change this behavior by setting the ``closeable`` parameter.
-Note that you need to explicitly start transactions by calling the
-``begin()`` method. This ensures that the transparent reopening will be
-suspended until the end of the transaction, and that the connection
-will be rolled back before being reused by the same thread.
+.. warning::
+ Note that you need to explicitly start transactions by calling the
+ ``begin()`` method. This ensures that the transparent reopening will be
+ suspended until the end of the transaction, and that the connection
+ will be rolled back before being reused by the same thread.
By setting the ``threadlocal`` parameter to ``threading.local``, getting
connections may become a bit faster, but this may not work in all
@@ -392,7 +393,7 @@ Instead of this, you can also get a dedicated connection as follows::
If you don't need it anymore, you should immediately return it to the
pool with ``db.close()``. You can get another connection in the same way.
-*Warning:* In a threaded environment, never do the following::
+⚠ Warning: In a threaded environment, never do the following::
pool.connection().cursor().execute(...)
@@ -414,11 +415,12 @@ You can also use context managers for simpler code::
cur.execute(...)
res = cur.fetchone()
-Note that you need to explicitly start transactions by calling the
-``begin()`` method. This ensures that the connection will not be shared
-with other threads, that the transparent reopening will be suspended
-until the end of the transaction, and that the connection will be rolled
-back before being given back to the connection pool.
+.. warning::
+ Note that you need to explicitly start transactions by calling the
+ ``begin()`` method. This ensures that the connection will not be shared
+ with other threads, that the transparent reopening will be suspended
+ until the end of the transaction, and that the connection will be rolled
+ back before being given back to the connection pool.
Advanced Usage