innov
/
django1
1
0
Fork 0
Code Issues Pull Requests 1 Projects Releases Wiki Activity

Edited doc changes from [17244] 

git-svn-id: http://code.djangoproject.com/svn/django/trunk@17302 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Adrian Holovaty 2011-12-30 18:01:34 +00:00
parent afb21094a9
commit d3ef13044e
3 changed files with 20 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
docs/ref/models/querysets.txt
View File

@ -376,20 +376,26 @@ query spans multiple tables, it's possible to get duplicate results when a
.. versionadded:: 1.4 .. versionadded:: 1.4
The possibility to pass positional arguments (``*fields``) is new in Django 1.4. As of Django 1.4, you can pass positional arguments (``*fields``) in order to
They are names of fields to which the ``DISTINCT`` should be limited. This specify the names of fields to which the ``DISTINCT`` should apply. This
translates to a ``SELECT DISTINCT ON`` SQL query. A ``DISTINCT ON`` query eliminates translates to a ``SELECT DISTINCT ON`` SQL query.
duplicate rows not by comparing all fields in a row, but by comparing only the given
fields. Here's the difference. For a normal ``distinct()`` call, the database compares
*each* field in each row when determining which rows are distinct. For a
``distinct()`` call with specified field names, the database will only compare
the specified field names.
.. note:: .. note::
Note that the ability to specify field names is only available in PostgreSQL. This ability to specify field names is only available in PostgreSQL.
.. note:: .. note::
When using the ``DISTINCT ON`` functionality it is required that the columns given When you specify field names, you *must* provide an ``order_by()`` in the
to :meth:`distinct` match the first :meth:`order_by` columns. For example ``SELECT QuerySet, and the fields in ``order_by()`` must start with the fields in
DISTINCT ON (a)`` gives you the first row for each value in column ``a``. If you ``distinct()``, in the same order.
don't specify an order, then you'll get some arbitrary row.
For example, ``SELECT DISTINCT ON (a)`` gives you the first row for each
value in column ``a``. If you don't specify an order, you'll get some
arbitrary row.
Examples:: Examples::

5
docs/releases/1.4-alpha-1.txt
View File

@ -548,10 +548,9 @@ Django 1.4 also includes several smaller improvements worth noting:
* Added support in the ORM for generating ``SELECT`` queries containing * Added support in the ORM for generating ``SELECT`` queries containing
``DISTINCT ON``. ``DISTINCT ON``.
The ``distinct()`` ``Queryset`` method now accepts an optional list of model The ``distinct()`` ``QuerySet`` method now accepts an optional list of model
field names. If specified, then the ``DISTINCT`` statement is limited to these field names. If specified, then the ``DISTINCT`` statement is limited to these
fields. PostgreSQL is the only database backend shipped with Django that fields. This is only supported in PostgreSQL.
supports this new functionality.
For more details, see the documentation for For more details, see the documentation for
:meth:`~django.db.models.query.QuerySet.distinct`. :meth:`~django.db.models.query.QuerySet.distinct`.

5
docs/releases/1.4.txt
View File

@ -538,10 +538,9 @@ Django 1.4 also includes several smaller improvements worth noting:
* Added support in the ORM for generating ``SELECT`` queries containing * Added support in the ORM for generating ``SELECT`` queries containing
``DISTINCT ON``. ``DISTINCT ON``.
The ``distinct()`` ``Queryset`` method now accepts an optional list of model The ``distinct()`` ``QuerySet`` method now accepts an optional list of model
field names. If specified, then the ``DISTINCT`` statement is limited to these field names. If specified, then the ``DISTINCT`` statement is limited to these
fields. PostgreSQL is the only database backend shipped with Django that fields. This is only supported in PostgreSQL.
supports this new functionality.
For more details, see the documentation for For more details, see the documentation for
:meth:`~django.db.models.query.QuerySet.distinct`. :meth:`~django.db.models.query.QuerySet.distinct`.