检索数据

查找所有匹配文档

要查找所有符合条件的文档，请使用find()方法。 此方法将查询筛选器作为参数。 查询筛选器由构成要匹配的文档条件的字段和值组成。

该方法返回一个Cursor类型，您可以遍历该类型以检索与过滤条件匹配的任何文档。

要查看使用此方法检索数据的示例，请参阅find() 示例。

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

查找一个文档

要查找第一个符合条件的文档，请使用find_one()方法。 此方法将查询筛选器作为参数。 查询筛选器由构成要匹配的文档条件的字段和值组成。

如果文档与筛选条件匹配，该方法将返回值为Some的Result<Option<T>>类型。 如果没有符合筛选条件的文档， find_one()将返回值为None的Result<Option<T>>类型。

要查看使用此方法检索数据的示例，请参阅find_one() 示例。

修改查找行为

您可以通过传递FindOptions实例作为参数来修改find()的行为，也可以通过传递FindOneOptions实例来修改find_one()的行为。

要使用每个设置的默认值，请将值None指定为选项参数。

下表描述了您可以在 FindOptions 和 FindOneOptions 中指定的常用设置：

有关可以为每种类型指定的设置的完整列表，请参阅 FindOptions 的 API 文档 和 FindOneOptions。

举例

以下部分包含使用find()和findOne()方法检索与过滤条件匹配的样本文档的示例。

let opts = FindOptions::builder()
    .sort(doc! { "unit_price": -1 })
    .build();
let mut cursor = my_coll.find(
    doc! { "$and": vec!
        [
            doc! { "unit_price": doc! { "$lt": 12.00 } },
            doc! { "category": doc! { "$ne": "kitchen" } }
        ] },
    opts
).await?;
while let Some(result) = cursor.try_next().await? {
    println!("{:?}", result);
};

let opts = FindOneOptions::builder().skip(2).build();
let result = my_coll.find_one(
    doc! { "unit_price":
        doc! { "$lte": 20.00 } },
    opts
).await?;
println!("{:#?}", result);

聚合文档数据

aggregate()方法将聚合管道作为参数。 聚合管道包括一个或多个指定如何转换数据的阶段。 阶段包括聚合操作符（以$为前缀）以及该操作符所需的任何参数。

要了解有关聚合的更多信息并查看聚合示例，请参阅聚合指南。

该方法以Cursor类型返回结果文档。 如果聚合管道不包含$match阶段，则管道会处理集合中的所有文档。

修改聚合行为

您可以通过将AggregateOptions实例作为可选参数传递来修改aggregate()的行为。

要使用每个设置的默认值，请将值None指定为选项参数。

下表描述了您可以在AggregateOptions中指定的常用设置：

有关设置的完整列表，请参阅 AggregateOptions 的 API 文档。

例子

此示例演示如何使用包含以下阶段的管道调用aggregate()方法：

• $group 阶段，按 category 字段对文档进行分组，并按 category 计算 unit_price 字段的平均值

• $sort阶段（按avg_price升序排列）

let pipeline = vec![
    doc! { "$group": doc! { "_id" : doc! {"category": "$category"} ,
                            "avg_price" : doc! { "$avg" : "$unit_price" } } },
    doc! { "$sort": { "_id.avg_price" : 1 } }
];
let mut cursor = my_coll.aggregate(pipeline, None).await?;
while let Some(result) = cursor.try_next().await? {
    println!("{:?}", result);
};

API 文档

要进一步了解本指南所提及的方法和类型，请参阅以下 API 文档：

• find_one()

• find()

• FindOptions

• FindOneOptions

• 游标

• 聚合(aggregate)()

• AggregateOptions