cursor.count()

定义

cursor.count()

重要

mongosh 方法

这是一个 mongosh方法。这不是Node.js或其他特定于编程语言的驱动程序方法的文档。

在大多数情况下， mongosh方法的工作方式与旧版mongo shell 方法相同。但是，某些旧方法在mongosh中不可用。

有关旧版mongo shell 文档，请参阅相应 MongoDB Server 版本的文档：

• mongo shell v4.4

• mongo Shell v4.2

• mongo Shell v4.0

对于 MongoDB API 驱动程序，请参阅特定语言的MongoDB 驱动程序文档。

注意

与 4.0 功能兼容的 MongoDB 驱动程序弃用了各自的游标和集合 count() API，转而使用与 countDocuments() 和 estimatedDocumentCount() 相对应的新 API。有关特定驱动程序的具体 API 名称，请参阅驱动程序 API 文档。

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

重要

• count()如果find() 操作在没有查询谓词的情况下运行，请避免使用 ，因为没有查询谓词，这些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()与count()一起使用。有关示例，请参阅指定要使用的索引。

提示

另请参阅：

cursor.size()

行为

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

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

{ a: 1, b: 1 }

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

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()

举例

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

db.orders.find().count()

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

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

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