db.collection.countDocuments()

在本页面

• 定义

• 行为

• 例子

定义

db.collection.countDocuments(query, options)

版本4.0.3中的新功能。

参数	类型	描述
query	document	查询选择条件。要计算所有文档，请指定一个空文档。另请参阅查询限制。
options	document	可选的。影响计数行为的其他选项。

该options文档可以包含以下内容：

字段	类型	描述
limit	integer	可选的。要计算的最大文件数。
skip	integer	可选的。计数前要跳过的文档数。
hint	string or document	可选的。用于查询的索引名称或索引规范。
maxTimeMS	integer	可选的。允许计数运行的最长时间。

行为

结构

与db.collection.count()， db.collection.countDocuments()不使用元数据返回计数不同。相反，它会执行文档的聚合以返回准确的计数，即使是在异常关闭后或分片群集中存在孤立的文档之后。

db.collection.countDocuments()包装以下聚合操作并仅返回的值n：

db.collection.aggregate([
    { $match: <query> },
    { $group: { _id: null, n: { $sum: 1 } } }
])

空或不存在的集合和视图

从版本4.2.1（和版本4.0.13中的4.0系列）开始， db.collection.countDocuments()返回0在一个空的或不存在的集合或视图。

在MongoDB的早期版本中，db.collection.countDocuments()查询空或不存在的集合或视图会报错。

查询限制

您不能在db.collection.countDocuments()中将以下查询运算符用作以下查询表达式的一部分：

限制操作符	替代
$where	使用$expr代替
$near	$geoWithin与$center一起使用。即： { $geoWithin: { $center: [ [ <x>, <y> ], <radius> ] } }
$nearSphere	$geoWithin与$centerSphere一起使用。即： { $geoWithin: { $centerSphere: [ [ <x>, <y> ], <radius> ] } }

事务

db.collection.countDocuments()可以在多文档事务中使用。

重要

在大多数情况下，与单文档写入相比，多文档事务产生的性能成本更高，并且多文档事务的可用性不应替代有效的架构设计。在许多情况下， 非规范化数据模型（嵌入式文档和数组）将继续是您的数据和用例的最佳选择。也就是说，在许多情况下，适当地对数据建模将最大程度地减少对多文档事务的需求。

有关其他事务使用方面的注意事项（例如运行时限制和操作日志大小限制），另请参见 生产注意事项。

客户端断开

从MongoDB 4.2开始，如果发出db.collection.countDocuments()断开连接的客户端 在操作完成之前断开连接，则MongoDB将标记为终止db.collection.countDocuments()（即在操作上killOp）。

例子

计算集合中的所有文档

要计算orders集合中所有文档的数量，请使用以下操作：

db.orders.countDocuments({})

计算与查询匹配的所有文档

计算orders 集合中具有ord_dt大于的字段的文档数：new Date('01/01/2012')：

db.orders.countDocuments( { ord_dt: { $gt: new Date('01/01/2012') } }, { limit: 100 } )

也可以看看

• db.collection.estimatedDocumentCount()

• $group 和 $sum

• count

• 带有count选项的collStats pipeline stage。

译者：李冠飞

校对：