Docs 菜单
Docs 主页
/
数据库手册
/
聚合操作
/
参考
/
阶段(Stages)

$count（聚合）

定义

$count

将文档传递到下一阶段，该阶段包含输入到该阶段的文档数的计数。

注意

消歧

本页介绍了 $count 聚合管道阶段。对于 $count 聚合累加器，请参阅 $count (aggregation accumulator)。

兼容性

可以使用 $count 查找托管在以下环境中的部署：

  • MongoDB Atlas：用于云中 MongoDB 部署的完全托管服务

语法

$count 通过以下语法实现：

{ $count: <string> }

<string> 是以计数为值的输出字段的名称。<string> 必须是非空字符串，不能以 $ 开头，也不能包含 . 字符。

行为

返回类型由可存储计数最终值的最小类型表示：integer →long →double

$count阶段相当于以下$group 和$project 序列：

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

myCount 是存储计数的输出字段。 您可以为输出字段指定其他名称。

如果输入数据集为空，则 $count 不会返回结果。

另请参阅：

db.collection.countDocuments() 使用 $sum 表达式包装 $group 聚合阶段。

示例

使用以下文档创建名为 scores 的集合：

db.scores.insertMany( [
   { "_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 }
] )

以下聚合操作有两个阶段：

  1. $match 阶段会排除 score 值小于或等于 80 的文档，以便将 score 大于 80 的文档传递到下一个阶段。

  2. $count 阶段会返回聚合管道中剩余文档的计数，并将该值分配给名为 passing_scores 的字段。

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

该操作返回以下结果：

{ "passing_scores" : 4 }

如果输入数据集为空，则 $count 不会返回结果。 以下示例不会返回结果，因为没有分数大于 99 的文档：

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

本页上的C#示例使用Atlas示例数据集中的 sample_mflix数据库。要学习；了解如何创建免费的MongoDB Atlas 群集并加载示例数据集，请参阅MongoDB .NET/ C#驱动程序文档中的入门。

以下 Movie 类对 sample_mflix.movies 集合中的文档进行建模：

public class Movie
{
    public string Id { get; set; }
    public int Runtime { get; set; }
    
    public string Title { get; set; }
    public string Rated { get; set; }
    public List<string> Genres { get; set; }
    public string Plot { get; set; }
    
    public ImdbData Imdb { get; set; }
    public int Year { get; set; }
    public int Index { get; set; }
    
    public string[] Comments { get; set; }
   
    [BsonElement("lastupdated")]
    public DateTime LastUpdated { get; set; }
}

要使用MongoDB .NET/ C#驾驶员将 $count 阶段添加到聚合管道，请对 PipelineDefinition对象调用 Count() 方法。

以下示例创建了一个管道阶段，用于计算输入文档的数量并返回一个将该计数作为其值的文档：

var pipeline = new EmptyPipelineDefinition<Movie>()
    .Count();

了解详情

后退

$collStats

来年

$currentOp

在此页面上