Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

Fixed #13869 - Warned that QuerySet.iterator() doesn't affect DB driv…

…er caching; thanks jtiai for the suggestion.
  • Loading branch information...
commit 2f722d9728c1946d5d800b3e0b24de7f566a755d 1 parent 4b27813
@timgraham timgraham authored
Showing with 10 additions and 0 deletions.
  1. +10 −0 docs/ref/models/querysets.txt
View
10 docs/ref/models/querysets.txt
@@ -1456,6 +1456,16 @@ evaluated will force it to evaluate again, repeating the query.
Also, use of ``iterator()`` causes previous ``prefetch_related()`` calls to be
ignored since these two optimizations do not make sense together.
+.. warning::
+
+ Some Python database drivers like ``psycopg2`` perform caching if using
+ client side cursors (instantiated with ``connection.cursor()`` and what
+ Django's ORM uses). Using ``iterator()`` does not affect caching at the
+ database driver level. To disable this caching, look at `server side
+ cursors`_.
+
+.. _server side cursors: http://initd.org/psycopg/docs/usage.html#server-side-cursors
+
latest
~~~~~~
Please sign in to comment.
Something went wrong with that request. Please try again.