annotate()

メソッドの定義

annotate(*args, **kwargs)

引数	Description
*args	参照するフィールド名を表す文字列、もしくはquery
**kwargs	戻り値で使うフィールド名

Querysetオブジェクトのメソッドの一つ。annotateは「注釈をつける」という意味。 その意味の通り、annotateを使うことでQuerysetに別の情報を付与することができる。

モデル名.objects.annotate()が基本形。

基本的な使い方

項目を指定しただけのシンプルな形。

annotateで利用可能な基本的な集計メソッド一覧

以下の通り、aggregateと同じメソッドを使うことができる

Method	Default alias	Description
Avg	<field>__avg	指定された項目の平均値
Count	<field>__count	指定された項目の数
Max	<field>__max	指定された項目の最大値
Min	<field>__min	指定された項目の最小値
StdDev	<field>__stddev	指定された項目の標準偏差
Sum	<field>__sum	指定された項目の合計値
Variance	<field>__variance