计算文档

样本数据

本指南中的示例使用restaurants sample_restaurantsAtlas示例数据集的 数据库中的 集合。要从Rust应用程序访问权限此集合，请创建一个连接到AtlasClient 集群的 ，并将以下值分配给my_coll 变量。

选择 Asynchronous或Synchronous标签页，查看每个运行时的相应代码：

let uri = "<connection string>";
let client = Client::with_uri_str(uri).await?;
let my_coll: Collection<Document> = client
    .database("sample_restaurants")
    .collection("restaurants");

let uri = "<connection string>";
let client = Client::with_uri_str(uri)?;
let my_coll: Collection<Document> = client
    .database("sample_restaurants")
    .collection("restaurants");

要学习；了解如何创建免费的MongoDB Atlas 群集并加载示例数据集，请参阅 Rust驱动程序入门指南。

本指南中的示例使用以下 Restaurant 结构作为 restaurants 集合中文档的模型：

#[derive(Serialize, Deserialize, Debug)]
struct Restaurant {
    name: String,
    cuisine: String,
}

对所有文档进行计数

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

let ct = my_coll.count_documents().await?;
println!("Number of matching documents: {}", ct);

Number of documents: 25216

let ct = my_coll.count_documents().run()?;
println!("Number of matching documents: {}", ct);

Number of documents: 25216

对特定文档进行计数

要返回匹配特定搜索条件的文档计数，请将查询过滤文档传递给count_documents()方法。

以下示例计算 name字段的值包含字符串 "Sunset" 的文档数量。选择 Asynchronous 或 Synchronous标签页，查看每个运行时的相应代码：

let ct = my_coll
    .count_documents(doc! { "name": doc! { "$regex": "Sunset" } })
    .await?;
println!("Number of matching documents: {}", ct);

Number of matching documents: 10

let ct = my_coll
    .count_documents(doc! { "name": doc! { "$regex": "Sunset" } })
    .run()?;
println!("Number of matching documents: {}", ct);

Number of matching documents: 10

自定义计数行为

您可以修改 count_documents() 方法的行为，方法是在 await 或 run() 方法调用之前将选项方法链接到 count_documents() 调用。下表描述了可设立自定义计数操作的选项：

自定义估计计数行为

您可以通过将选项方法链接到 estimated_document_count() 调用来修改 estimated_document_count() 方法的行为。下表描述了可用于自设立估计计数操作的选项：