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和$sumcount
译者：李冠飞
校对：