/ /

/ /

计算文档

Overview

在本指南中，您可以了解如何检索集合中文档数量的准确估计数。

使用count_documents()方法计算集合中的文档数量。要计算与特定Atlas Search条件匹配的文档数量，请将包含查询筛选器的字典传递给 count_documents() 方法。

要学习；了解有关指定查询的更多信息，请参阅指定查询。

要返回集合中所有文档的计数，请将空字典传递给 count_documents() 方法，如以下示例所示。选择Synchronous或Asynchronous标签页以查看相应的代码：

collection.count_documents({})

await collection.count_documents({})

要返回匹配特定搜索条件的文档计数，请在 count_documents() 方法中指定您的查询，如以下示例所示。选择Synchronous或Asynchronous标签页以查看相应的代码：

collection.count_documents({ "author": "Mike" })

await collection.count_documents({ "author": "Mike" })

count_documents()方法接受可选参数，这些参数表示可用于配置计数操作的选项。如果不指定任何选项，驱动程序不会自定义计数操作。

下表描述了可以设置用于自定义count_documents()的选项：

您可以通过调用estimated_document_count()方法来估计集合中的文档数量。该方法根据集合元数据估计文档数量，这可能比执行精确计数更快。

以下示例估计集合中的文档数。选择 Synchronous 或 Asynchronous标签页，查看相应的代码：

collection.estimated_document_count()

await collection.estimated_document_count()

estimated_document_count()方法接受可选参数，这些参数表示可用于配置计数操作的选项。如果不指定任何选项，驱动程序不会自定义计数操作。

下表描述了可以设置用于自定义estimated_document_count()的选项：

属性	说明
`comment`	要附加到操作的注释。
`maxTimeMS`	允许操作运行的最长时间（以毫秒为单位）。

PyMongo 不再支持count()方法。请改用Collection类中的count_documents()方法。

count_documents()方法属于Collection类。如果您尝试调用Cursor.count_documents() ，PyMongo 会引发以下错误：

Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
AttributeError: 'Cursor' object has no attribute 'count'

要进一步了解本指南所讨论的任何方法或类型，请参阅以下 API 文档：

后退

指定要返回的字段

来年

非重复字段值