$count (aggregation)

Definition定义

$count

Passes a document to the next stage that contains a count of the number of documents input to the stage.将文档传递到下一阶段，该阶段包含输入到该阶段的文档数的计数。

Note注意

Disambiguation消除歧义

This page describes the $count aggregation pipeline stage. 本页介绍$count聚合管道阶段。For the $count aggregation accumulator, see $count (aggregation accumulator).有关$count聚合累加器，请参阅$count (aggregation accumulator)（聚合累加器）。

$count has the following prototype form:具有以下原型形式：

{ $count: <string> }

<string> is the name of the output field which has the count as its value. 以计数作为其值的输出字段的名称。<string> must be a non-empty string, must not start with $ and must not contain the . character.<string>必须是非空字符串，不能以$开头，并且不能包含.字符。

Tip提示

See also: 参阅：

• db.collection.countDocuments()
• $collStats
• db.collection.estimatedDocumentCount()
• count
• db.collection.count()

Behavior行为

The $count stage is equivalent to the following $group + $project sequence:$count阶段相当于以下$group+$project序列：

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

where myCount would be the output field that contains the count. 其中myCount将是包含计数的输出字段。You can specify another name for the output field.可以为输出字段指定其他名称。

Example示例

A collection named scores has the following documents:名为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 }

The following aggregation operation has two stages:以下聚合操作分为两个阶段：

1. The $match stage excludes documents that have a score value of less than or equal to 80 to pass along the documents with score greater than 80 to the next stage.$match阶段不包括score值小于或等于80的文档，以便将score大于80的文档传递到下一阶段。
2. The $count stage returns a count of the remaining documents in the aggregation pipeline and assigns the value to a field called passing_scores.$count阶段返回聚合管道中剩余文档的计数，并将值分配给名为passing_scores的字段。

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

The operation returns the following results:该操作返回以下结果：

{ "passing_scores" : 4 }