ドキュメントをカウント

サンプル データ

このガイドの例では、Atlasサンプルデータセットのsample_restaurantsデータベースにあるrestaurantsコレクションを使用します。Rustアプリケーションからこのコレクションにアクセスするには、Atlas クラスターに接続する Client を作成し、次の値を 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ドライバーを使い始める のガイドを参照してください。

このガイドの例では、 restaurantsコレクション内のドキュメントのモデルとして次のRestaurant構造体を使用します。

#[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フィールドの値に string "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() メソッドの動作を変更できます。次の表では、推定カウント操作 をカスタマイズするために設定できるオプションについて説明します。