/ /

$sum（アキュムレータ演算子）

定義

$sum

ドキュメントのグループ全体の数値の合計を返します。

$sumアキュムレータは、次のステージで使用できます。

注意

$sum のその他の用途

このページでは、アキュムレータとして使用する場合の$sum について説明します。アキュムレータは、入力ドキュメントのグループ全体の合計、最大、最小などの集計値を返します。

次の他のコンテキストでは $sum を使用することもできます。

$sum (expression)は、配列内の数値の合計を返します。
$sum (window function)$setWindowFieldsは、ウィンドウ内の値の累積合計を計算するためにステージで使用されます。

構文

{ $sum: <expression> }

動作

結果の型

入力型が混在している場合、$sum は小さい入力型を 2 つのうち大きい方にプロモートします。型は、より幅広い値を表す場合、より大きな値と見なされます。数値型の最小値から最大値の順は、integer → long → double → decimal です。

演算がオーバーフローして、大きい方のデータ型で表される範囲を超えない限り、大きい方の入力型によって結果型も決まります。オーバーフローの場合、$sum は以下の順序に従って結果を昇格させます。

より大きな入力型が integer の場合、結果型は long に昇格します。
より大きな入力型が long の場合、結果型は double に昇格します。
より大きな型がdouble またはdecimal の場合、オーバーフローした結果は正の無限大または負の無限大として表されます。結果の型の昇格はありません。

数値以外の値のフィールドまたは存在しないフィールド

数値と数値以外の値の両方を含むフィールドで $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 }
   }
] )

[
  { _id: 'G', totalVotes: 12773015 },
  { _id: 'PG', totalVotes: 57205811 },
  { _id: 'PG-13', totalVotes: 152323029 },
  { _id: 'R', totalVotes: 209762435 }
]

先行するパイプライン:

を使用して、 $matchrated値が、、、またはで、かつ整数GPG PG-13RIMDB 投票数を持つ映画をフィルタリングします。
$groupを使用して映画をrated フィールドでグループ化し、totalVotes $sumでを使用してimdb.votes を計算します。
$sortを使用して、コンテンツ評価のアルファベット順で結果を返します。

詳細

戻る

$stdDevSamp

$top