Django双下划线查询

在 Django 中,双下划线(__)查询是一种强大的语法,用于在 ORM(对象关系映射)中跨关联模型进行字段查询,或使用内置查询表达式(如过滤、聚合等)。以下是其核心用法和示例:

1. 跨关联模型查询

通过双下划线可以引用关联模型(ForeignKey、ManyToManyField、OneToOneField)的字段。

示例模型:

复制代码
class Author(models.Model):
    name = models.CharField(max_length=100)

class Book(models.Model):
    title = models.CharField(max_length=100)
    author = models.ForeignKey(Author, on_delete=models.CASCADE)

查询示例:

复制代码
# 查询作者名为"Alice"的所有书籍
books = Book.objects.filter(author__name="Alice")

# 查询所有写过标题包含"Python"的书籍的作者
authors = Author.objects.filter(book__title__icontains="Python")

2. 字段查找表达式

双下划线后可接多种查询表达式,如:
比较运算符

exact:精确匹配(默认)

gt、gte、lt、lte:大于、大于等于、小于、小于等于

in:包含在列表中

range:范围查询

示例:

复制代码
# 查询价格大于100的产品
products = Product.objects.filter(price__gt=100)

# 查询ID为1、3、5的用户
users = User.objects.filter(id__in=[1, 3, 5])

字符串处理

contains、icontains:包含(区分 / 不区分大小写)

startswith、istartswith:以... 开头

endswith、iendswith:以... 结尾

regex、iregex:正则表达式匹配

示例:

复制代码
# 查询邮箱以"@gmail.com"结尾的用户
users = User.objects.filter(email__endswith="@gmail.com")

日期和时间处理

year、month、day:提取日期部分

hour、minute、second:提取时间部分

date:日期比较

time:时间比较

示例:

复制代码
# 查询2023年创建的订单
orders = Order.objects.filter(created_at__year=2023)

# 查询昨天创建的所有对象
from datetime import date, timedelta
yesterday = date.today() - timedelta(days=1)
objects = MyModel.objects.filter(created_at__date=yesterday)

空值和布尔值

isnull:是否为空(True/False)

exact:布尔值匹配

示例:

复制代码
# 查询没有关联图片的文章
articles = Article.objects.filter(image__isnull=True)

# 查询已发布的文章
articles = Article.objects.filter(is_published__exact=True)

3. 多级跨关联查询

可以通过多个双下划线连接多层关联模型。

示例模型:

复制代码
class Country(models.Model):
    name = models.CharField(max_length=100)

class City(models.Model):
    name = models.CharField(max_length=100)
    country = models.ForeignKey(Country, on_delete=models.CASCADE)

class User(models.Model):
    name = models.CharField(max_length=100)
    city = models.ForeignKey(City, on_delete=models.CASCADE)

查询示例:

复制代码
# 查询来自中国北京的所有用户
users = User.objects.filter(city__name="Beijing", city__country__name="China")

4. 聚合查询与双下划线

在聚合函数(如Sum、Avg)中也可使用双下划线跨模型引用字段。

示例:

复制代码
from django.db.models import Sum
# 计算每个作者的总书籍销量
authors = Author.objects.annotate(total_sales=Sum("book__sales"))

注意事项

性能问题:多级跨关联可能导致 SQL 查询复杂度增加,建议结合select_related()或prefetch_related()优化。

反向关联:通过关联模型反向查询时,默认使用模型名小写加_set(如author.book_set.all()),但在双下划线查询中可直接使用模型名小写(如author__name)。

空值处理:使用跨关联查询时,若关联对象不存在,查询结果可能为空,需谨慎处理。

通过双下划线查询,Django ORM 可以简洁地表达复杂的数据库查询逻辑,避免编写原生 SQL。

相关推荐
大G的笔记本1 小时前
MySQL 大表查询优化、超大分页处理、SQL 慢查询优化、主键选择
数据库·sql·mysql
Lear1 小时前
Redis 持久化机制
数据库
儒道易行2 小时前
【攻防实战】Redis未授权RCE联动metasploit打穿三层内网(上)
数据库·redis·网络安全·缓存
小宁爱Python2 小时前
从零搭建 RAG 智能问答系统 6:Text2SQL 与工作流实现数据库查询
数据库·人工智能·python·django
yjsstar2 小时前
数据库MySQL基础
数据库·mysql
云边有个稻草人2 小时前
KingbaseES数据库性能调优指南:从理论到实践的全链路解析
数据库·金仓数据库
nianniannnn2 小时前
Qt布局管理停靠窗口QDockWidget类
开发语言·数据库·c++·qt·qt5·qt6.3
TDengine (老段)3 小时前
TDengine 配置参数作用范围对比
大数据·数据库·物联网·时序数据库·tdengine·涛思数据
幼儿园老大*3 小时前
什么是分布式数据库?有什么优势?
数据库·分布式
运维行者_3 小时前
DDI 与 OpManager 集成对企业 IT 架构的全维度优化
运维·网络·数据库·华为·架构·1024程序员节·snmp监控