コレクションから単一ドキュメントを検索するには、 インスタンスで find_one() Collection
メソッドを呼び出します。
クエリフィルターをfind_one()
メソッドに渡すと、コレクション内でフィルターに一致する 1 つのドキュメントが返されます。 複数のドキュメントがクエリフィルターに一致する場合、このメソッドはデータベース内の自然な順序に従って、またはFindOneOptions
インスタンスに指定されたソート順序に従って最初に一致するドキュメントを返します。
find_one()
メソッドは Option<T> T
Collection
タイプを返します。ここで、 は インスタンスをパラメータ化したタイプです。
ドキュメントの取得の詳細については、「 データの取得」ガイドを参照してください。
例
この例では、 sample_restaurants
データベース内のrestaurants
コレクションからクエリフィルターに一致するドキュメントを検索します。 この例では、検索されたドキュメントのデータをRestaurant
構造体に入力します。
この例では、 name
フィールドの値が"Tompkins Square Bagels"
であるドキュメントに一致するクエリフィルターを使用します。 MongoDB は、クエリフィルターに一致する最初のドキュメントを検索します。
AsynchronousSynchronous各実行時に対応するコードを表示するには、 タブまたは タブを選択します。
use mongodb::{ bson::doc, Client, Collection }; use serde::{ Deserialize, Serialize }; struct Restaurant { name: String, cuisine: String, } async fn main() -> mongodb::error::Result<()> { let uri = "<connection string>"; let client = Client::with_uri_str(uri).await?; let my_coll: Collection<Restaurant> = client .database("sample_restaurants") .collection("restaurants"); let result = my_coll.find_one( doc! { "name": "Tompkins Square Bagels" }, None ).await?; println!("{:#?}", result); Ok(()) }
Some( Restaurant { name: "Tompkins Square Bagels", cuisine: "American", }, )
use mongodb::{ bson::doc, sync::{Client, Collection} }; use serde::{ Deserialize, Serialize }; struct Restaurant { name: String, cuisine: String, } fn main() -> mongodb::error::Result<()> { let uri = "<connection string>"; let client = Client::with_uri_str(uri)?; let my_coll: Collection<Restaurant> = client .database("sample_restaurants") .collection("restaurants"); let result = my_coll.find_one( doc! { "name": "Tompkins Square Bagels" }, None )?; println!("{:#?}", result); Ok(()) }
Some( Restaurant { name: "Tompkins Square Bagels", cuisine: "American", }, )