/ /

$sum（式）

定義

$sum

配列内の数値の合計を返します。

注意

$sum のその他の用途

このページでは、配列内の数値の合計を返す式として使用される場合の$sum について説明します。

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

$sum (accumulator)は、ドキュメントのグループ全体の数値の合計を返します。
$sum (window function)$setWindowFieldsは、ウィンドウ内の値の累積合計を計算するためにステージで使用されます。

構文

式として使用する場合、$sum は次の 2 つの構文のいずれかをとります。

{ $sum: <expression> }

上記の構文では、オペランドは配列として評価される単一の式です。 $sum は配列をトラバースし、配列の数値の合計を返します。

{ $sum: [ <expression1>, <expression2>, ... ] }

上記の構文では、各式は単一の数値です。 $sum は、それらの値の合計を返します。

動作

結果の型

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

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

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

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

数値と数値以外の値の両方を含むフィールドで使用される場合、$sum は数値以外の値を無視し、数値の合計を返します。

すべてのオペランドが数値以外の場合、$sum は 0 を返します。

例

このページの例では、 sample_mflix データセットのデータを使用します。このデータセットを自己管理型MongoDBデプロイにロードする方法の詳細については、「サンプルデータセットをロードする」を参照してください。サンプルデータベースに変更を加えた場合、このページの例を実行するには、データベースを削除して再作成する必要がある場合があります。

この例では、$sum $projectステージのを使用して、3 つの映画の賞の合計を計算し、その結果をtotalAwards という新しいフィールドに保存します。

db.movies.aggregate( [
   {
      $match: {
         title: {
            $in: [
               "The Godfather",
               "Inception",
               "The Dark Knight"
            ]
         }
      }
   },
   {
      $project: {
         _id: 0,
         title: 1,
         totalAwards: { $sum: [ "$awards.wins", "$awards.nominations" ] }
      }
   },
   {
      $sort: { totalAwards: -1 }
   }
] )

[
  { title: 'Inception', totalAwards: 334 },
  { title: 'The Dark Knight', totalAwards: 250 },
  { title: 'The Godfather', totalAwards: 52 }
]

先行するパイプライン:

$match3 つの特定の映画をフィルタリングするには、を使用します。
$project$sumtotalAwardsをawards.wins awards.nominationsと併用して、各映画のとの合計を保持するフィールドを作成します。
$sortを使用して、結果を合計の降順で並べ替えます。

戻る

$subtract

$switch