计数

定义¶

count¶

计算集合或视图中的文档数。返回包含此计数以及命令状态的文档。

注意

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

count 具有以下形式：

注意

从4.2版开始，MongoDB对count命令的选项名称实施更严格的验证。现在，如果您指定未知的选项名称，该命令将出错。

复制

{
  count: <collection or view>,
  query: <document>,
  limit: <integer>,
  skip: <integer>,
  hint: <hint>,
  readConcern: <document>,
  collation: <document>
}

count 具有以下字段：

领域	类型	描述
count	串	要计数的集合或视图的名称。
query	文献	可选的。一个查询，用于选择要在集合或视图中计数的文档。
limit	整数	可选的。要返回的匹配文件的最大数量。
skip	整数	可选的。返回结果前要跳过的匹配文档数。
hint	字符串或文件	可选的。要使用的索引。指定索引名称为字符串或索引规范文档。
readConcern	文献	可选的。指定读取关注。该选项具有以下语法： 复制 readConcern: { level: <value> } 可能的阅读关注级别为： "local"。当与因果一致的会话相关联时，这是针对主要对象的读取操作和针对次要对象的读取操作的默认读取关注级别。 "available"。当不与因果关系一致的会话关联时，这是针对次要对象的读取的默认设置。该查询返回实例的最新数据。 "majority"。可用于使用WiredTiger存储引擎的副本集 。 "linearizable"。仅可用于读取操作 primary。 有关阅读关注级别的更多信息，请参阅 阅读关注级别。
collation	文献	可选的。 指定 用于操作的排序规则。 归类允许用户为字符串比较指定特定于语言的规则，例如字母大写和重音符号的规则。 排序规则选项具有以下语法： 复制 collation: { locale: <string>, caseLevel: <boolean>, caseFirst: <string>, strength: <int>, numericOrdering: <boolean>, alternate: <string>, maxVariable: <string>, backwards: <boolean> } 指定排序规则时，该locale字段为必填字段；所有其他排序规则字段都是可选的。有关字段的说明，请参见整理文档。 如果未指定排序规则，但是集合具有默认排序规则（请参阅参考资料db.createCollection()），则该操作将使用为集合指定的排序规则。 如果没有为集合或操作指定排序规则，则MongoDB使用先前版本中使用的简单二进制比较进行字符串比较。 您不能为一个操作指定多个排序规则。例如，您不能为每个字段指定不同的排序规则，或者如果对排序执行查找，则不能对查找使用一种排序规则，而对排序使用另一种排序规则。 3.4版的新功能。

该mongo外壳程序还提供以下包装方法count：

• count()
• db.collection.estimatedDocumentCount()
• db.collection.count()

重要

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

行为¶

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

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

例子¶

以下各节提供了该count 命令的示例。

db.runCommand( { count: 'orders' } )

{ "n" : 26, "ok" : 1 }

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

{ "n" : 13, "ok" : 1 }

db.runCommand( { count:'orders',
                 query: { ord_dt: { $gt: new Date('01/01/2012') } },
                 skip: 10 }  )

{ "n" : 3, "ok" : 1 }

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

{ "n" : 1, "ok" : 1 }

db.runCommand(
   {
     count: "restaurants",
     query: { rating: { $gte: 4 } },
     readConcern: { level: "majority" }
   }
)