diff options
| author | Tim Graham <timograham@gmail.com> | 2012-10-20 15:21:19 -0400 |
|---|---|---|
| committer | Tim Graham <timograham@gmail.com> | 2012-10-20 15:23:06 -0400 |
| commit | 6c1c490f64bb5114570a45a523bec365f89f681d (patch) | |
| tree | 92aedd07ea36bf527af6e4330e1eaad4366799ed | |
| parent | 13bbe9161d38d3c0778577a3547fab2d181a8e5e (diff) | |
[1.4.X] Fixed #13869 - Warned that QuerySet.iterator() doesn't affect DB driver caching; thanks jtiai for the suggestion.
Backport of 2f722d9728 from master
| -rw-r--r-- | docs/ref/models/querysets.txt | 10 |
1 files changed, 10 insertions, 0 deletions
diff --git a/docs/ref/models/querysets.txt b/docs/ref/models/querysets.txt index da0e3e66ce..a32c9f50fd 100644 --- a/docs/ref/models/querysets.txt +++ b/docs/ref/models/querysets.txt @@ -1451,6 +1451,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 ~~~~~~ |