Commit 683b3dff authored by Tim Graham's avatar Tim Graham
Browse files

[1.8.x] Fixed #21422 -- Documented that prefetch_related() results must be homogeneous.

Backport of 69239c0f from master
parent a00bdceb
Loading
Loading
Loading
Loading
+4 −1
Original line number Diff line number Diff line
@@ -898,7 +898,10 @@ many-to-many and many-to-one objects, which cannot be done using
``select_related``, in addition to the foreign key and one-to-one relationships
that are supported by ``select_related``. It also supports prefetching of
:class:`~django.contrib.contenttypes.fields.GenericRelation` and
:class:`~django.contrib.contenttypes.fields.GenericForeignKey`.
:class:`~django.contrib.contenttypes.fields.GenericForeignKey`, however, it
must be restricted to a homogeneous set of results. For example, prefetching
objects referenced by a ``GenericForeignKey`` is only supported if the query
is restricted to one ``ContentType``.

For example, suppose you have these models::