AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

$sum (式)

$sum

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

注意

その他の $sum の使用方法

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

$sum は、これらの他のコンテキストでも使用できます。

式として使用する場合、$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 配置にこのデータセットをロードする方法の詳細については、「サンプル データセットのロード」を参照してください。サンプル データベースに何らかの変更を加えた場合は、今ページの例を実行するには、データベースを削除して再作成する必要がある可能性があります。

この例では、$project ステージで $sum を使用して、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 } }] )

以前のパイプライン:

  • $matchを使用して3本の特定の映画をフィルターします。

  • $sum とともに $project を使用して、totalAwards フィールドを作成します。このフィールドには、各映画の awards.wins と awards.nominations の合計が格納されます。

  • $sort を使用して、合計受賞額の降順で結果をソートします。

このページを評価