MongoDB-CN-Manual
搜索文档…
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
1
db.collection.aggregate([
2
{ $match: <query> },
3
{ $group: { _id: null, n: { $sum: 1 } } }
4
])
Copied!

空或不存在的集合和视图

从版本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集合中所有文档的数量,请使用以下操作:
1
db.orders.countDocuments({})
Copied!

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

计算orders 集合中具有ord_dt大于的字段的文档数:new Date('01/01/2012')
1
db.orders.countDocuments( { ord_dt: { $gt: new Date('01/01/2012') } }, { limit: 100 } )
Copied!
也可以看看
  • db.collection.estimatedDocumentCount()
  • $group$sum
  • count
  • 带有count选项的collStats pipeline stage。
译者:李冠飞
校对:
最近更新 1mo ago