Commit 6c1c490f authored by Tim Graham's avatar Tim Graham
Browse files

[1.4.X] Fixed #13869 - Warned that QuerySet.iterator() doesn't affect DB... 

[1.4.X] Fixed #13869 - Warned that QuerySet.iterator() doesn't affect DB driver caching; thanks jtiai for the suggestion.

Backport of 2f722d97 from master
parent 13bbe916

docs/ref/models/querysets.txt

+10 −0
Original line number Diff line number Diff line
@@ -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

~~~~~~