Docs Menu
Docs Home
/
MongoDBマニュアル
/
集計操作
/
参照
/
ステージ

$count（集計）

項目一覧

  • 定義
  • 互換性
  • 構文
  • 動作
  • 例

定義

$count

ステージに入力されたドキュメントの数を含むドキュメントを次のステージに渡します。

注意

曖昧さ回避

このページでは、 $count集計パイプライン ステージについて説明します。 $count集計アキュムレータについては、 $count (aggregation accumulator)を参照してください。

互換性

次の環境でホストされる配置には $count を使用できます。

  • MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです

  • MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン

  • MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

構文

$count には、次のプロトタイプ形式があります。

{ $count: <string> }

<string> はカウントを値として持つ出力フィールドの名前です。<string> には空でない文字列であること、$ で始まらないこと、. 文字を含まないことという条件があります。

Tip

以下も参照してください。

動作

戻り値の型は、カウントの最終値を保持できる最小の型で表されます: integer → long → double

$countステージは、次の$group + $projectシーケンスと同等です。

db.collection.aggregate( [
   { $group: { _id: null, myCount: { $sum: 1 } } },
   { $project: { _id: 0 } }
] )

上記で、myCount はカウントを含む出力フィールドです。この出力フィールドには別の名前を指定できます。

Tip

以下も参照してください。

db.collection.countDocuments() は、$group 集計ステージを$sum 式でラップします。

例

scores という名前のコレクションには次のドキュメントが含まれています。

{ "_id" : 1, "subject" : "History", "score" : 88 }
{ "_id" : 2, "subject" : "History", "score" : 92 }
{ "_id" : 3, "subject" : "History", "score" : 97 }
{ "_id" : 4, "subject" : "History", "score" : 71 }
{ "_id" : 5, "subject" : "History", "score" : 79 }
{ "_id" : 6, "subject" : "History", "score" : 83 }

次の集計操作には 2 つのステージがあります。

  1. $match ステージでは、score 値が 80 以下であるドキュメントを除外し、score 値が 80 を超えるドキュメントを次のステージに渡します。

  2. $count ステージは、集計パイプラインに残っているドキュメントの数を返し、その値を passing_scores というフィールドに割り当てます。

db.scores.aggregate(
  [
    {
      $match: {
        score: {
          $gt: 80
        }
      }
    },
    {
      $count: "passing_scores"
    }
  ]
)

この操作は次の結果を返します。

{ "passing_scores" : 4 }

戻る

$collStats

次へ

$currentOp