/ /

$count（聚合阶段）

定义

$count

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

注意

消歧

本页介绍了 $count 聚合管道阶段。您还可以在以下其他场景中使用 $count：

$count (accumulator), 返回群组中的文档数。
$count (window function)，用于在 $setWindowFields 阶段中返回特定窗口中的文档数。

兼容性

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

MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud

MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本
MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本

语法

$count 通过以下语法实现：

{ $count: <string> }

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

行为

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

The $count stage is equivalent to the following $group and $project sequence:

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

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

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

提示

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

示例

本页上的示例使用来自 sample_mflix 数据集的数据。有关如何将此数据集加载到您的自管理 MongoDB 部署中的详细信息，请参阅加载示例数据集。如果您对示例数据库进行了任何修改，您可能需要删除并重新创建数据库，才能运行此页面上的示例。

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

$match 阶段筛选 metacritic 等于 100 的文档，以仅将这些文档传递到下一阶段。
$count 阶段会返回聚合管道中剩余文档的计数，并将该值分配给名为 perfect_score_count 的字段。

db.movies.aggregate( [
   { $match: { metacritic: { $eq: 100 } } },
   { $count: "perfect_score_count" }
] )

[ { perfect_score_count: 8 } ]

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

[BsonIgnoreExtraElements]
public class Movie
{
    [BsonId]
    public ObjectId Id { get; set; }
    [BsonElement("title")]
    public string Title { get; set; } = null!;
    [BsonElement("year")]
    public int? Year { get; set; }
    [BsonElement("runtime")]
    public int? Runtime { get; set; }
    [BsonElement("rated")]
    public string? Rated { get; set; }
    [BsonElement("metacritic")]
    public int Metacritic { get; set; }
    [BsonElement("plot")]
    public string? Plot { get; set; }
    [BsonElement("type")]
    public string? Type { get; set; }
    [BsonElement("cast")]
    public string[]? Cast { get; set; }
    [BsonElement("directors")]
    public string[]? Directors { get; set; }
    [BsonElement("writers")]
    public string[]? Writers { get; set; }
    [BsonElement("imdb")]
    public ImdbData? Imdb { get; set; }
}

var pipeline = new EmptyPipelineDefinition<Movie>()
    .Match(Builders<Movie>.Filter.Eq(m => m.Metacritic, 100))
    .Count();

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

要使用MongoDB Node.js驱动程序将 $count 阶段添加到聚合管道，请在管道对象中使用 $count操作符。

以下示例创建了一个管道阶段，用于计算 sample_mflix.movies集合中输入文档的数量并返回包含计数的文档。然后，该示例运行聚合管道：

const pipeline = [{ $count: "movies" }];
const cursor = collection.aggregate(pipeline);
return cursor;

了解详情