Overview
在本指南中，您可以学习如何使用Ruby驱动程序来检索集合中文档数量的准确估计数。以下方法对集合中的文档进行计数：
count_documents：返回与查询过滤匹配或存在于集合中的文档的确切数量estimated_document_count：返回集合中存在的文档的估计数量
样本数据
本指南中的示例使用Atlas示例数据集的 sample_training数据库中的 companies集合。要从Ruby应用程序访问权限此集合，请创建一个连接到Atlas 集群的Mongo::Client对象，并将以下值分配给 database 和 collection 变量：
database = client.use('sample_training') collection = database['companies']
要学习如何创建免费的MongoDB Atlas 集群并加载示例数据集，请参阅MongoDB 入门指南。
检索准确的计数
使用count_documents方法计算集合中的文档数量。 要计算匹配特定搜索条件的文档数量，请将查询过滤传递给count_documents方法。
提示
要了解有关指定查询的更多信息，请参阅指定查询指南。
对所有文档进行计数
要返回集合中所有文档的计数，请调用 count_documents 方法而不传递查询过滤，如以下示例所示：
result = collection.count_documents puts "Number of documents: #{result}"
Number of documents: 9500
对特定文档进行计数
要返回匹配特定搜索条件的文档计数，请将查询过滤传递给count_documents方法。
以下示例计算founded_year字段的值为2010的文档数量：
result = collection.count_documents(founded_year: 2010) puts "Number of companies founded in 2010: #{result}"
Number of companies founded in 2010: 33
自定义计数行为
您可以通过传递指定选项值的第二个参数来修改 count_documents 方法的行为。下表描述了可设立自定义计数操作的选项：
选项 | 说明 |
|---|---|
| 用于操作的排序规则。 |
| 用于操作的索引。 |
| 要添加到操作的注释。 |
| 要计数的最大文档数。此值必须为正整数。 |
| 操作可以运行的最长时间（毫秒）。 |
| 在对文档进行计数之前要跳过的文档数。 |
| 用于操作的读取偏好（read preference）。要了解更多信息，请参阅 MongoDB Server 手册中的读取偏好（read preference）。 |
以下示例使用count_documents方法计算number_of_employees字段值为50的文档数量，并指示操作最多计算100结果：
result = collection.count_documents({ number_of_employees: 50 }, limit: 100) puts "Number of companies with 50 employees: #{result}"
Number of companies with 50 employees: 100
重要
将选项参数传递给 count_documents 方法时，必须将查询过滤括在方括号 ({}) 中。
检索估计计数
您可以通过调用estimated_document_count方法来检索集合中文档数量的估计值。 该方法根据集合元数据估计文档数量，这可能比执行精确计数更快。
以下示例估计集合中的文档数量：
result = collection.estimated_document_count puts "Estimated number of documents: #{result}"
Estimated number of documents: 9500
自定义估计计数行为
您可以通过传递指定选项值的参数来修改 estimated_document_count 方法的行为。下表描述了可设立用于自定义操作的选项：
选项 | 说明 |
|---|---|
| 要添加到操作的注释。 |
| 操作可以运行的最长时间（毫秒）。 |
| 用于操作的读关注（read concern）。要了解更多信息，请参阅 MongoDB Server 手册中的读关注（read concern）。 |
以下示例使用estimated_document_count方法返回集合中文档数量的估计值，并将操作超时设置为1000毫秒：
result = collection.estimated_document_count(max_time_ms: 1000) puts "Estimated number of documents: #{result}"
Estimated number of documents: 9500
API 文档
要进一步了解本指南所讨论的任何方法，请参阅以下 API 文档：