快捷導(dǎo)航

Django ORM:values()和annotate()方法的使用

更新時(shí)間：2025年07月05日 15:39:29 作者：言之。

本文介紹Django ORM中values()和annotate()的用法,values()返回字典形式的查詢結(jié)果,annotate()添加計(jì)算字段,兩者結(jié)合可實(shí)現(xiàn)分組統(tǒng)計(jì),注意使用順序以優(yōu)化性能

1. values()方法

1.1 基本概念

values()方法用于返回一個(gè)包含字典的QuerySet，而不是模型實(shí)例。每個(gè)字典表示一個(gè)對(duì)象，鍵對(duì)應(yīng)于模型字段名稱。

1.2 基本用法

# 獲取所有書(shū)籍的標(biāo)題和出版日期
from myapp.models import Book

books = Book.objects.values('title', 'pub_date')
# 返回結(jié)果示例: [{'title': 'Django入門', 'pub_date': datetime.date(2023, 1, 1)}, ...]

1.3 特點(diǎn)

只獲取指定字段，減少內(nèi)存使用
結(jié)果以字典形式返回，而不是模型實(shí)例
可以用于跨模型關(guān)系查詢

1.4 關(guān)聯(lián)查詢

# 獲取書(shū)籍及其作者姓名
books = Book.objects.values('title', 'author__name')

2. annotate()方法

2.1 基本概念

annotate()用于給QuerySet中的每個(gè)對(duì)象添加計(jì)算字段（注解），通常與聚合函數(shù)一起使用。

2.2 基本用法

from django.db.models import Count
from myapp.models import Author

# 計(jì)算每位作者的書(shū)籍?dāng)?shù)量
authors = Author.objects.annotate(book_count=Count('book'))
# 現(xiàn)在每個(gè)author對(duì)象都有一個(gè)book_count屬性

2.3 常用聚合函數(shù)

Count(): 計(jì)數(shù)
Sum(): 求和
Avg(): 平均值
Max(): 最大值
Min(): 最小值

3. values()和annotate()的組合使用

3.1 分組統(tǒng)計(jì)

# 按出版社分組統(tǒng)計(jì)書(shū)籍?dāng)?shù)量
from django.db.models import Count

stats = Book.objects.values('publisher').annotate(count=Count('id'))
# 返回結(jié)果示例: [{'publisher': 'A出版社', 'count': 5}, ...]

3.2 多字段分組

# 按作者和出版年份分組統(tǒng)計(jì)
stats = Book.objects.values('author', 'pub_date__year').annotate(count=Count('id'))

3.3 注意事項(xiàng)

values()在annotate()之前使用會(huì)改變分組依據(jù)
annotate()在values()之前使用會(huì)為每個(gè)對(duì)象添加注解

4. 實(shí)際案例

4.1 博客系統(tǒng)統(tǒng)計(jì)

# 統(tǒng)計(jì)每個(gè)分類下的文章數(shù)量和平均閱讀量
from django.db.models import Count, Avg

stats = Post.objects.values('category').annotate(
    post_count=Count('id'),
    avg_views=Avg('views')
)

4.2 電商系統(tǒng)分析

# 統(tǒng)計(jì)每個(gè)用戶的總消費(fèi)金額和訂單數(shù)
from django.db.models import Sum, Count

user_stats = Order.objects.values('user').annotate(
    total_spent=Sum('amount'),
    order_count=Count('id')
)