db.collection.count（）

定义¶

db.collection.count（查询，选项）¶

mongo 壳法

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

注意

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

返回与find()集合或视图查询匹配的文档数 。该 db.collection.count()方法不执行 find()操作，而是计算并返回与查询匹配的结果数。

重要

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

参数	类型	描述
query	文献	查询选择条件。
options	文献	可选的。用于修改计数的其他选项。

该options文档包含以下字段：

领域	类型	描述
limit	整数	可选的。要计算的最大文件数。
skip	整数	可选的。计数前要跳过的文档数。
hint	字符串或文件	可选的。索引名称提示或查询规范。
maxTimeMS	整数	可选的。允许查询运行的最长时间。
readConcern	串	可选的。指定读取关注。默认级别为 "local"。 若要使用关注级别"majority"，副本集必须使用WiredTiger存储引擎。 您可以"majority"为具有三名成员的主次仲裁器（PSA）架构的部署禁用读取关注。但是，这对变更流（仅在MongoDB 4.0和更早版本中）和分片群集上的事务有影响。有关更多信息，请参见禁用多数阅读关注。 为确保单个线程可以读取其自己的写入，"majority"请对"majority" 副本集的主数据库使用 读取关注和写入关注。 要使用的关注度"majority"，您必须指定一个非空query条件。 3.2版中的新功能。
collation	文献	可选的。 指定 用于操作的排序规则。 归类允许用户为字符串比较指定特定于语言的规则，例如字母大写和重音符号的规则。 排序规则选项具有以下语法： 复制 collation: { locale: <string>, caseLevel: <boolean>, caseFirst: <string>, strength: <int>, numericOrdering: <boolean>, alternate: <string>, maxVariable: <string>, backwards: <boolean> } 指定排序规则时，该locale字段为必填字段；所有其他排序规则字段都是可选的。有关字段的说明，请参见整理文档。 如果未指定排序规则，但是集合具有默认排序规则（请参阅参考资料db.createCollection()），则该操作将使用为集合指定的排序规则。 如果没有为集合或操作指定排序规则，则MongoDB使用先前版本中使用的简单二进制比较进行字符串比较。 您不能为一个操作指定多个排序规则。例如，您不能为每个字段指定不同的排序规则，或者如果对排序执行查找，则不能对查找使用一种排序规则，而对排序使用另一种排序规则。 3.4版的新功能。

count()等价于 db.collection.find(query).count()构造。

行为¶

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

例子¶

db.orders.count()

db.orders.find().count()

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

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