cursor.count（）_MonogDB 中文网

MongoDB 中文手册

参考 > 参考 > mongo Shell方法 > 游标方法 > cursor.count（）

在本页面

定义
行为
例子

定义¶

cursor.count（）¶

mongo 壳法

此页面记录了mongoshell方法，并且没有引用MongoDB Node.js驱动程序（或任何其他驱动程序）方法。对于相应的MongoDB驱动程序API，请改为参考您特定的 MongoDB驱动程序文档。

注意

与4.0功能兼容的MongoDB驱动程序弃用各自的光标和收集count()的API支持对应于新的API countDocuments()和 estimatedDocumentCount()。有关给定驱动程序的特定API名称，请参阅驱动程序API文档。

计算光标引用的文档数。将count()方法附加到 find()查询以返回匹配文档的数量。该操作不执行查询，而是计算查询将返回的结果。

重要

count()如果在find()没有查询谓词的情况下运行操作，请避免使用，因为如果没有查询谓词，这些操作 count()将基于集合的元数据返回结果，这可能会导致近似计数。特别是，
- 在分片群集上，结果计数将无法正确过滤出孤立的文档。
- 不正常关机后，计数可能不正确。
有关基于集合元数据的计数，另请参阅带有count 选项的collStats管道阶段。

该count()方法具有以下原型形式：

复制

db.collection.find(<query>).count()

该count()方法具有以下参数：

参数	类型	描述
`applySkipLimit`	布尔值	可选的。指定是否在计数中考虑`cursor.skip()`和`cursor.limit()`方法的影响。默认情况下，该`count()`方法忽略的影响`cursor.skip()`和 `cursor.limit()`。设置`applySkipLimit`要`true`考虑这些方法的效果。

MongoDB还提供了等效db.collection.count() 的替代方案db.collection.find(<query>).count() 。

MongoDB支持hint()with 的使用count()。有关示例，请参见指定要使用的索引。

也可以看看

cursor.size()

行为¶

数量和交易¶

您不能在 count助手count()和事务中使用和外壳助手。db.collection.count()

有关详细信息，请参见事务和计数操作。

分片群集¶

在分片群集上，如果存在孤立的文档或正在进行块迁移，则在count()没有查询谓词的情况下find会导致计数 不准确。

为避免这些情况，请在分片群集上使用以下 db.collection.aggregate()方法：

您可以使用$count舞台来计数文档。例如，以下操作对集合中的文档进行计数：

复制

db.collection.aggregate( [
   { $count: "myCount" }
])

该$count阶段等效于以下 $group+ $project序列：

复制

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

也可以看看

$collStats 返回基于集合的元数据的近似计数。

索引使用¶

考虑具有以下索引的集合：

复制

{ a: 1, b: 1 }

执行计数时，在以下情况下，MongoDB仅可以使用索引返回计数：

查询可以使用索引，
该查询仅包含索引键上的条件，并且
查询谓词访问单个连续范围的索引键。

例如，以下操作可以仅使用索引返回计数：

复制

db.collection.find( { a: 5, b: 5 } ).count()
db.collection.find( { a: { $gt: 5 } } ).count()
db.collection.find( { a: 5, b: { $gt: 10 } } ).count()

但是，如果查询可以使用索引，但是查询谓词不能访问单个连续的索引键范围，或者查询还包含索引外部字段的条件，那么除了使用索引之外，MongoDB还必须阅读文档返回计数。

复制

db.collection.find( { a: 5, b: { $in: [ 1, 2, 3 ] } } ).count()
db.collection.find( { a: { $gt: 5 }, b: 5 } ).count()
db.collection.find( { a: 5, b: 5, c: 5 } ).count()

在这种情况下，在初次读取文档期间，MongoDB会将文档分页到内存中，以便随后进行相同计数操作的调用将具有更好的性能。

例子¶

以下是该count()方法的示例。

统计所有文档¶

以下操作计算orders集合中所有文档的数量：

复制

db.orders.find().count()

计算与查询匹配的文档¶

以下操作对orders字段中ord_dt大于的集合中的文档数进行计数：new Date('01/01/2012')

复制

db.orders.find( { ord_dt: { $gt: new Date('01/01/2012') } } ).count()

限制文件数¶

以下操作计算该orders字段中ord_dt大于考虑到的影响的集合中文档的数量：new Date('01/01/2012') limit(5)

复制

db.orders.find( { ord_dt: { $gt: new Date('01/01/2012') } } ).limit(5).count(true)

指定要使用的索引¶

以下操作使用名为的索引"status_1"（其索引键规范为）返回集合中具有大于且等于的文档的数量：{ status: 1 }ordersord_dtnew Date('01/01/2012')status"D"

复制

db.orders.find(
   { ord_dt: { $gt: new Date('01/01/2012') }, status: "D" }
).hint( "status_1" ).count()