Django 1.0 中文文档-----查询方法参考-优快云博客

查询API参考

这篇文档详细描述了QuerySet API,是以现有的模型资料和数据库查询知道为基础，所以你在这之前需要阅读和理解这些文档。

在这篇参考中，我们用现有的weblog例子。

当QuerySets被求值

在内部，QuerySet被构造，过滤，裁切，分发，没有实际接触数据库直到被求值的时候。

你可以通过下面方法对QuerySet 求值

跌送. QuerySet 是可跌送的，并且首先执行数据库查询。例如, 这个会打印数据库里所有entries 的 headline

for e in Entry.objects.all():
    print e.headline

切片. 像说的那样限制QuerySets, QuerySet 可以被切片, 用Python的 array-slicing 语法. 通常切段 QuerySet会返回另一个QuerySet, 但是Django会执行数据库查询当你用 "step"切片参数语法.

序列化/缓存. 看下面的部分，详细介绍了当序列化 QuerySets涉及到的东西.Queryset结果从数据库里读取的重要

repr(). 当调用repr()时候QuerySet会被求值. 这是为了方便Python的交互解释, 因此当执行API交互时，你会立即看到结果

len(). 当调用len()时候QuerySet会被求值. 如你所预计的，这会返回queryset数量.

list(). 强制求值
例如
```
entry_list = list(Entry.objects.all())
```

QuerySet API

尽管你通常不会手动创建一个，你会通过一个Manager,这个声明的QuerySet

class QuerySet ([ model=None ] )

通常当你要和QuerySet交互,你会用过滤链的方式,大多数 QuerySet 的方法都会返回一个新的QuerySet

QuerySet方法返回新的QuerySet

filter(**kwargs)

返回一个匹配查询参数后的新的QuerySet

exclude(**kwargs)

返回一个不匹配查询参数后的新的QuerySet

Entry.objects.exclude(pub_date__gt=datetime.date(2005, 1, 3), headline='Hello')

转化为SQL

SELECT ...
WHERE NOT (pub_date > '2005-1-3' AND headline = 'Hello')

Entry.objects.exclude(pub_date__gt=datetime.date(2005, 1, 3)).exclude(headline='Hello')

转化为SQL

SELECT ...
WHERE NOT pub_date > '2005-1-3'
OR NOT headline = 'Hello'

这个例子排除了所有pub_date大于 '2005-1-3' 或 headline 为 "hello" 的结果

`order_by(*fields)`

排序 Entry.objects.filter(pub_date__year=2005).order_by('-pub_date', 'headline')

前面带 “-” 为降序

`reverse()`

将查询结果排序反转

`distinct()`

去重复

`values(*fields)`

把查询结果转化为字典列表取代model集合

# This list contains a Blog object.
>>> Blog.objects.filter(name__startswith='Beatles')
[<Blog: Beatles Blog>]

# This list contains a dictionary.
>>> Blog.objects.filter(name__startswith='Beatles').values()
[{'id': 1, 'name': 'Beatles Blog', 'tagline': 'All the latest Beatles news.'}]

同样也可以指定结果字段名

>>> Blog.objects.values()
[{'id': 1, 'name': 'Beatles Blog', 'tagline': 'All the latest Beatles news.'}],
>>> Blog.objects.values('id', 'name')
[{'id': 1, 'name': 'Beatles Blog'}]

`values_list(*fields)`

将查询结果集的model转化为元组

>>> Entry.objects.values_list('id', 'headline')
[(1, u'First entry'), ...]

>>> Entry.objects.values_list('id').order_by('id')
[(1,), (2,), (3,), ...]

>>> Entry.objects.values_list('id', flat=True).order_by('id')
[1, 2, 3, ...]

`all()`

取所有结果

`select_related()`

取关联数据，可设置关联数据的深度，如果不设置，关联数据为延迟加载方式读取。

# Hits the database.
e = Entry.objects.get(id=5)

# Hits the database again to get the related Blog object.
b = e.blog


# Hits the database.
e = Entry.objects.select_related().get(id=5)

# Doesn't hit the database, because e.blog has been prepopulated
# in the previous query.
b = e.blog


class City(models.Model):
    # ...

class Person(models.Model):
    # ...
    hometown = models.ForeignKey(City)

class Book(models.Model):
    # ...
    author = models.ForeignKey(Person)


b = Book.objects.select_related().get(id=4)
p = b.author         # Doesn't hit the database.
c = p.hometown       # Doesn't hit the database.

b = Book.objects.get(id=4) # No select_related() in this example.
p = b.author         # Hits the database.
c = p.hometown       # Hits the database.

`extra(select=None, where=None, params=None, tables=None, order_by=None, select_params=None`

扩展查询

有时候DJANGO的查询API不能方便的设置查询条件，提供了另外的扩展查询方法extra

select

Entry.objects.extra(select={'is_recent': "pub_date > '2006-01-01'"})

Blog.objects.extra(
    select={
        'entry_count': 'SELECT COUNT(*) FROM blog_entry WHERE blog_entry.blog_id = blog_blog.id'
    },
)

Blog.objects.extra(
    select=SortedDict([('a', '%s'), ('b', '%s')]),
    select_params=('one', 'two'))

where / tables

Entry.objects.extra(where=['id IN (3, 4, 5, 20)'])

order_by

q = Entry.objects.extra(select={'is_recent': "pub_date > '2006-01-01'"})
q = q.extra(order_by = ['-is_recent'])

params

Entry.objects.extra(where=['headline=%s'], params=['Lennon'])