定義
ドキュメントグループ全体の数値の合計を返します。
$sum アキュムレータは次のステージで使用可能です。
注意
その他の $sum の使用方法
このページでは、$sum をアキュムレータとして使用する場合について説明します。アキュムレータは、入力ドキュメントのグループ全体で、合計、最大値、最小値などのような集計値を返します。
$sum は、これらの他のコンテキストでも使用できます。
$sum (expression), 配列内の数値の合計を返します。$sum (window function)は、$setWindowFieldsステージで使用され、ウィンドウ内の値の累積合計を計算します。
構文
{ $sum: <expression> }動作
結果の型
入力型が混在している場合、$sum は小さい入力型を 2 つのうち大きい方に昇格させます。型が大きいとみなされるのは、より広い範囲の値を表す場合です。数値型の最小値から最大値の順は、integer → long → double → decimal です。
演算がオーバーフローして、大きい方のデータ型で表される範囲を超えない限り、大きい方の入力型によって結果型も決まります。オーバーフローの場合、$sum は以下の順序に従って結果を昇格させます。
数値以外の値のフィールドまたは存在しないフィールド
数値と数値以外の値の両方を含むフィールドで $sum を使用する場合、$sum は数値以外の値を無視し、数値の合計を返します。
コレクション内のどのドキュメントにも存在しないフィールドで$sumを使用する場合、$sumはそのフィールドの0を返します。
例
このページの例では、sample_mflix データセット のデータを使用しています。自己管理型 MongoDB 配置にこのデータセットをロードする方法の詳細については、「サンプル データセットのロード」を参照してください。サンプル データベースに何らかの変更を加えた場合は、今ページの例を実行するには、データベースを削除して再作成する必要がある可能性があります。
次の例では、映画をコンテンツ評価でグループ化し、各グループの IMDb 投票総数を返します。
db.movies.aggregate( [ { $match: { rated: { $in: [ "G", "PG", "PG-13", "R" ] }, "imdb.votes": { $type: "int" } } }, { $group: { _id: "$rated", totalVotes: { $sum: "$imdb.votes" } } }, { $sort: { _id: 1 } }] )以前のパイプライン：