diff options
| author | Hasan Ramezani <hasan.r67@gmail.com> | 2019-02-13 03:35:49 +0100 |
|---|---|---|
| committer | Tim Graham <timograham@gmail.com> | 2019-02-12 21:35:49 -0500 |
| commit | f63811f4813f0e0439e140a97eeba18a5017e858 (patch) | |
| tree | e6f7b90ea3ea9097de8b900045a07cc502c09088 /docs | |
| parent | 3b64e2b77570c73a0d7092124fa73439e0fb4305 (diff) | |
Fixed #29943 -- Doc'd that admin changelist may add pk to ordering.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/ref/contrib/admin/index.txt | 11 |
1 files changed, 11 insertions, 0 deletions
diff --git a/docs/ref/contrib/admin/index.txt b/docs/ref/contrib/admin/index.txt index 75ad811e69..b4fa8c5035 100644 --- a/docs/ref/contrib/admin/index.txt +++ b/docs/ref/contrib/admin/index.txt @@ -1037,6 +1037,17 @@ subclass:: If you need to specify a dynamic order (for example depending on user or language) you can implement a :meth:`~ModelAdmin.get_ordering` method. + .. admonition:: Performance considerations with ordering and sorting + + To ensure a deterministic ordering of results, the changelist adds + ``pk`` to the ordering if it can't find a single or unique together set + of fields that provide total ordering. + + For example, if the default ordering is by a non-unique ``name`` field, + then the changelist is sorted by ``name`` and ``pk``. This could + perform poorly if you have a lot of rows and don't have an index on + ``name`` and ``pk``. + .. attribute:: ModelAdmin.paginator The paginator class to be used for pagination. By default, |