From bf5125734ebb9148eb455c05dbc872876f91e2b8 Mon Sep 17 00:00:00 2001 From: Adrian Holovaty Date: Wed, 28 Dec 2005 19:18:48 +0000 Subject: [PATCH] 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 --- docs/db-api.txt | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/db-api.txt b/docs/db-api.txt index a83b7dad6a..bb0011d6e2 100644 --- a/docs/db-api.txt +++ b/docs/db-api.txt @@ -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 ====================