Added note to docs/db-api.txt about using distinct=True with get_values()

git-svn-id: http://code.djangoproject.com/svn/django/trunk@1786 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Adrian Holovaty 2005-12-28 19:18:48 +00:00
parent de72616ac0
commit bf5125734e
1 changed files with 5 additions and 1 deletions

View File

@ -398,7 +398,11 @@ which rows are returned. Both ``limit`` and ``offset`` should be integers which
will be directly passed to the SQL ``LIMIT``/``OFFSET`` commands.
If ``distinct`` is True, only distinct rows will be returned. This is equivalent
to a ``SELECT DISTINCT`` SQL clause.
to a ``SELECT DISTINCT`` SQL clause. You can use this with ``get_values()`` to
get distinct values. For example, this returns the distinct first_names::
>>> people.get_values(fields=['first_name'], distinct=True)
[{'first_name': 'Adrian'}, {'first_name': 'Jacob'}, {'first_name': 'Simon'}]
Other lookup options
====================