extra(self, select=None, where=None, params=None, tables=None,
order_by=None, select_params=None)
# Adds extra SQL fragments to the query.
有些情况下,Django的查询语法难以简单的表达复杂的 WHERE 子句,对于这种情况, Django 提供了 extra() QuerySet修改机制 — 它能在 QuerySet生成的SQL从句中注入新子句。
extra可以指定一个或多个 参数,例如 select, where or tables. 这些参数都不是必须的,但是你至少要使用一个!要注意这些额外的方式对不同的数据库引擎可能存在移植性问题.(因为你在显式的书写SQL语句),除非万不得已,尽量避免这样做。
参数之select
select 参数可以让你在 SELECT 从句中添加其他字段信息,它应该是一个字典,存放着属性名到 SQL 从句的映射。
models.Article.objects.filter(nid=1)
.extra(select={"standard_time":"strftime('%%Y-%%m-%%d',create_time)","is_admin":0})
.values('nid','title','standard_time','is_admin')
#
SELECT (strftime('%Y-%m-%d',create_time)) AS "standard_time",
(0) AS "is_admin",
"blog_article"."nid",
"blog_article"."title"
FROM "blog_article"
WHERE "blog_article"."nid" = 1 LIMIT 21; args=(1,)
结果集中每个 Entry 对象都有两个额外的属性standard_time和is_admin,表示该用户的格式化创建时间和是否为管理员。
参数之where / tables
可以使用where定义显式SQL WHERE子句 - 也许执行非显式连接。
可以使用tables手动将表添加到SQL FROM子句。
where和tables都接受字符串列表。所有where参数均为“与”任何其他搜索条件。
models.Article.objects
.extra(where=['nid in (1,2,3) OR title like "py%" ','nid>2'])
.values('title')
SELECT "blog_article"."title"
FROM "blog_article"
WHERE (nid in (1,2,3) OR title like "py%" ) AND (nid>2)
LIMIT 21;