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：

    1. db.collection.aggregate([
    2.     { $match: <query> },
    3.     { $group: { _id: null, n: { $sum: 1 } } }
    4. ])

    空或不存在的集合和视图

    从版本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集合中所有文档的数量，请使用以下操作：

    1. db.orders.countDocuments({})

    计算与查询匹配的所有文档

    计算orders 集合中具有ord_dt大于的字段的文档数：new Date('01/01/2012')：

    1. db.orders.countDocuments( { ord_dt: { $gt: new Date('01/01/2012') } }, { limit: 100 } )

    也可以看看

    • db.collection.estimatedDocumentCount()
    • $group 和 $sum
    • count
    • 带有count选项的collStats pipeline stage。

    译者：李冠飞

    校对：

    参见

    原文 - db.collection.countDocuments()