MongoDB における 集計 (Aggregatioin) の 基本

現在のステージに含まれるドキュメント数を指定したプロパティ名へ設定します。

{ $count: "total" }

指定されたキー（_id）でグループ化を行います。 通常、統計関数をあわせて利用します。

{
  $group: {
    _id: "$item",
    total: { $sum: "$amount" }
  }
}

指定された件数までとなるようドキュメントを絞り込みます。

{ $limit: 15 }

先頭から指定された件数分のドキュメントを除外します。

{ $skip: 5 }

指定されたキーでソートします。 1 は 昇順、-1 は降順。

{ $sort: { total: -1 } }

指定された条件に合致するドキュメントのみとなるよう絞り込みます。

{ $match: { datetime: /2017-12/g } }

返却するドキュメントを再フォーマットします。

{
  $project: {
    _id: 0, item: 1, amount: 1
  }
}

等値。

{ $eq: [ "$amount", 250 ] }

非等値。

{ $ne: [ "$amount", 250 ] }

より大きい。

{ $gt: [ "$amount", 250 ] }

より大きいか等しい。

{ $gte: [ "$amount", 250 ] }

より小さい。

{ $lt: [ "$amount", 250 ] }

より小さいか等しい。

{ $lte: [ "$amount", 250 ] }

論理積演算。

{ $and: [ { $gte: [ "$amount", 5 ] }, { $lt: [ "$amount", 10 ] } ] }

論理和演算。

{ $or: [ { $lt: [ "$amount", 5 ] }, { $gte: [ "$amount", 10 ] } ] }

論理否定演算。

{ $not: [ { $gt: [ "$qty", 250 ] } ] }

加算。

{ $add: [ "$price", "$fee" ] }

減算。

{ $subtract: [ "$price", "$discount" ] }

乗算。

{ $multiply: [ "$price", "$quantity" ] }

除算。

{ $divide: [ "$hours", 8 ] }

剰余演算。

{ $mod: [ "$hours", "$tasks" ] }

切り上げ。

{ $ceil: "$value" }

切り捨て。

{ $floor: "$value" }

指数演算。以下のサンプルは分散を求める計算。

{ $pow: [ { $stdDevPop: "$scores.score" }, 2 ] } }

平方根。以下のサンプルは2点間の距離を求める計算。

{
  $sqrt: {
    $add: [
      { $pow: [ { $subtract: [ "$p2.y", "$p1.y" ] }, 2 ] },
      { $pow: [ { $subtract: [ "$p2.x", "$p1.x" ] }, 2 ] }
    ]
  }
}

絶対値。以下のサンプルは2値間の大きさを求める計算。

{ $abs: { $subtract: [ "$start", "$end" ] } }

最小値。

{ $min: "$amount" }

最大値。

{ $max: "$amount" }

平均値。

{ $avg: "$amount" }

合計値。

{ $sum: "$amount" }

母標準偏差。

{ $stdDevPop: "$score" }

年。

{ $year: "$date" }

月。 1 ～ 12 。

{ $month: "$date" }

月の中の日付。 1 ～ 31。

{ $dayOfMonth: "$date" }

曜日を示す値。 1(日曜) ～ 7(土曜)。

{ $dayOfWeek: "$date" }

時。 0 ～ 23 。

{ $hour: "$date" }

分。 0 ～ 59 。

{ $minute: "$date" }

秒。 0 ～ 60 (うるう秒) 。

{ $second: "$date" }

文字列の UTF-8 バイト長を取得します。

{ $strLenBytes: "description" }

指定された文字列が現れる UTF-8 バイトインデックスを取得します。 見つからなかった場合は -1 が戻ります。

{ $indexOfBytes: [ "$item", "e" ] }

指定された文字列を結合します。

{ $concat: [ "$item", " - ", "$description" ] }

文字列の一部を取得します。 指定された UTF-8 バイトインデックスから、指定されたバイト数分取得します。

{ $substrBytes: [ "$description", 0, 2 ] }

文字列を指定された区切り文字で分割します。

{ $split: ["$city", ","] }

小文字に変換します。

{ $toLower: "$description" }

大文字に変換します。

{ $toUpper: "$description" }

if 文。 オブジェクトも引数としてとれます。

{ $cond: { if: { $gte: [ "$amount", 10 ] }, then: 1, else: 0 } }

{ $cond: [ { $gte: [ "$amount", 10 ] }, 1, 0 ] }

switch 文。 一連の論理式を評価して最初に true となる式を実行します。

{
  $switch: {
    branches: [
      { case: { $gt: [ "$amount", 0 ] }, then: "> 0" },
      { case: { $gt: [ "$amount", 5 ] }, then: "> 5" }
    ],
    default: "Did not match"
  }
}