빠른 참조

이 페이지에서는 Rust 드라이버를 사용하여 몇 가지 일반적인 MongoDB 작업을 수행하는 예제를 확인할 수 있습니다. 다음 표의 각 행에는 작업에 대한 설명, 작업을 실행하기 위한 드라이버 구문, 관련 참고 및 API 문서에 대한 링크가 포함되어 있습니다.

Rust 드라이버는 비동기 애플리케이션을 실행하기 위한 비동기 런타임을 제공합니다. 또한 드라이버는 블로킹 동기 런타임을 지원합니다. 다음 표에 나열된 각 MongoDB 작업에 대해 비동기 및 동기 API를 모두 사용하는 예제를 볼 수 있습니다.

팁

비동기 및 동기 런타임에 학습 보려면 비동기 및 동기 API 가이드 를 참조하세요.

명령

구문

Find a Document

API Documentation
Fundamentals Guide
Usage Example

비동기 런타임

let result = collection.find_one(doc! { "title": "Peter Pan" }).await?;

런타임 동기화

let result = collection.find_one(doc! { "title": "Peter Pan" }).run()?;

Find Multiple Documents

API Documentation
Fundamentals Guide
Usage Example

비동기 런타임

let filter = doc! { "year": 1925 };
let mut cursor = collection.find(filter).await?;

런타임 동기화

let filter = doc! { "year": 1925 };
let mut cursor = collection.find(filter).run()?;

Insert a Document

API Documentation
Fundamentals Guide
Usage Example

비동기 런타임

let doc = doc! {
    "title": "Mistress America", "type": "movie"
};
let result = collection.insert_one(doc).await?;

런타임 동기화

let doc = doc! {
    "title": "Mistress America", "type": "movie"
};
let result = collection.insert_one(doc).run()?;

Insert Multiple Documents

API Documentation
Fundamentals Guide
Usage Example

비동기 런타임

let docs = vec![
    doc! { "title": "Friends With Money", "runtime": 88 },
    doc! { "title": "Please Give", "runtime": 90 },
    doc! { "title": "You Hurt My Feelings", "runtime": 93 },
];
let result = collection.insert_many(docs).await?;

런타임 동기화

let docs = vec![
    doc! { "title": "Friends With Money", "runtime": 88 },
    doc! { "title": "Please Give", "runtime": 90 },
    doc! { "title": "You Hurt My Feelings", "runtime": 93 },
];
let result = collection.insert_many(docs).run()?;

Update a Document

API Documentation
Fundamentals Guide
Usage Example

비동기 런타임

let filter = doc! { "title": "Burn After Reading"};
let update = doc! {
        "$set": doc!{ "num_mflix_comments": 1 }
};
let result = collection.update_one(filter, update).await?;

런타임 동기화

let filter = doc! { "title": "Burn After Reading"};
let update = doc! {
        "$set": doc!{ "num_mflix_comments": 1 }
};
let result = collection.update_one(filter, update).run()?;

Update Multiple Documents

API Documentation
Fundamentals Guide
Usage Example

비동기 런타임

let filter = doc! { "rated": "PASSED"};
let update = doc! {
        "$set": doc!{ "rated": "Not Rated" }
};
let result = collection.update_many(filter, update).await?;

런타임 동기화

let filter = doc! { "rated": "PASSED"};
let update = doc! {
        "$set": doc!{ "rated": "Not Rated" }
};
let result = collection.update_many(filter, update).run()?;

Replace a Document

API Documentation
Fundamentals Guide
Usage Example

비동기 런타임

let filter = doc! { "title": "è Nous la Libertè" };
let replacement = doc! {
    "title": "À nous la liberté",
    "type": "movie",
    "directors": vec! [ "René Clair" ]
};
let result = collection.replace_one(filter, replacement).await?;

런타임 동기화

let filter = doc! { "title": "è Nous la Libertè" };
let replacement = doc! {
    "title": "À nous la liberté",
    "type": "movie",
    "directors": vec! [ "René Clair" ]
};
let result = collection.replace_one(filter, replacement).run()?;

Delete a Document

API Documentation
Fundamentals Guide
Usage Example

비동기 런타임

let filter = doc! { "title": "Search and Destroy" };
let result = collection.delete_one(filter).await?;

런타임 동기화

let filter = doc! { "title": "Search and Destroy" };
let result = collection.delete_one(filter).run()?;

Delete Multiple Documents

API Documentation
Fundamentals Guide
Usage Example

비동기 런타임

let filter = doc! {
    "year": doc! { "$lt": 1920 }
};
let result = collection.delete_many(filter).await?;

런타임 동기화

let filter = doc! {
    "year": doc! { "$lt": 1920 }
};
let result = collection.delete_many(filter).run()?;

Access Data from a Cursor Iteratively

API Documentation
Fundamentals Guide

비동기 런타임

let mut cursor = collection
    .find(doc! { "$and": vec!
    [
        doc! { "metacritic": doc! { "$gt": 90 } },
        doc! { "directors": vec! [ "Martin Scorsese" ] }
    ] })
    .await?;
while let Some(result) = cursor.try_next().await? {
    println!("{}", result);
}

런타임 동기화

let cursor = collection
    .find(doc! { "$and": vec!
    [
        doc! { "metacritic": doc! { "$gt": 90 } },
        doc! { "directors": vec! [ "Martin Scorsese" ] }
    ] })
    .run()?;
for result in cursor {
    println!("{}", result?);
}

Access Data from a Cursor as an Array

API Documentation
Fundamentals Guide

비동기 런타임

let cursor = collection.find(doc! { "title": "Secrets & Lies" }).await?;
let results: Vec<Document> = cursor.try_collect().await?;

런타임 동기화

let cursor = collection.find(doc! { "title": "Secrets & Lies" }).run()?;
let results: Vec<Result<Document>> = cursor.collect();

Count Documents

API Documentation
Usage Example

비동기 런타임

let filter = doc! {
    "languages": vec! [ "Mandarin" ]
};
let result = collection.count_documents(filter).await?;

런타임 동기화

let filter = doc! {
    "languages": vec! [ "Mandarin" ]
};
let result = collection.count_documents(filter).run()?;

List Distinct Values of a Field

API Documentation
Usage Example

비동기 런타임

let field_name = "title";
let filter = doc! {
    "directors": vec! [ "Sean Baker" ]
};
let results = collection.distinct(field_name, filter).await?;

런타임 동기화

let field_name = "title";
let filter = doc! {
    "directors": vec! [ "Sean Baker" ]
};
let results = collection.distinct(field_name, filter).run()?;

Limit the Number of Documents Retrieved

API Documentation

비동기 런타임

let filter = doc! { "awards.wins": 25};
let mut cursor = collection.find(filter).limit(5).await?;

런타임 동기화

let filter = doc! { "awards.wins": 25};
let mut cursor = collection.find(filter).limit(5).run()?;

Skip Retrieved Documents

API Documentation

비동기 런타임

let filter = doc! { "runtime": 100 };
let mut cursor = collection.find(filter).skip(1).await?;

런타임 동기화

let filter = doc! { "runtime": 100 };
let mut cursor = collection.find(filter).skip(1).run()?;

Sort the Documents When Retrieving Them

API Documentation

비동기 런타임

let filter = doc! {
    "directors": vec! [ "Nicole Holofcener" ]
};
let mut cursor = collection
    .find(filter)
    .sort(doc! { "imdb.rating": 1 })
    .await?;

런타임 동기화

let filter = doc! {
    "directors": vec! [ "Nicole Holofcener" ]
};
let mut cursor = collection
    .find(filter)
    .sort(doc! { "imdb.rating": 1 })
    .run()?;

Project Document Fields When Retrieving Them

API Documentation

비동기 런타임

let filter = doc! { "year": 2015 };
let mut cursor = collection
    .find(filter)
    .projection(doc! { "title": 1, "metacritic": 1, "_id": 0 })
    .await?;

런타임 동기화

let filter = doc! { "year": 2015 };
let mut cursor = collection
    .find(filter)
    .projection(doc! { "title": 1, "metacritic": 1, "_id": 0 })
    .run()?;

Create an Index

API Documentation

비동기 런타임

let index: IndexModel = IndexModel::builder().keys(doc! { "title": 1 }).build();
let result = collection.create_index(index).await?;

런타임 동기화

let index: IndexModel = IndexModel::builder().keys(doc! { "title": 1 }).build();
let result = collection.create_index(index).run()?;

돌아가기

다음 단계

새로운 기능