ドキュメントをカウント

サンプル データ

このガイドの例では、 Atlasサンプルデータセットのsample_trainingデータベースのcompaniesコレクションを使用します。 C++アプリケーションからこのコレクションにアクセスするには、Atlasmongocxx::client クラスターに接続する をインスタンス化し、次の値をdb 変数とcollection 変数に割り当てます。

auto db = client["sample_training"];
auto collection = db["companies"];

MongoDB Atlasクラスターを無料で作成して、サンプルデータセットをロードする方法については、MongoDBを使い始めるガイドを参照してください。

すべてのドキュメントをカウントする

コレクション内のすべてのドキュメントの数を返すには、次の例に示すように、空の フィルタードキュメントをcount_documents()メソッドに渡します。

auto result = collection.count_documents({});
std::cout << "Number of documents: " << result << std::endl;

Number of documents: 9500

特定のドキュメントのカウント

特定の検索条件に一致するドキュメントの数を返すには、クエリフィルタードキュメントをcount_documents()メソッドに渡します。

次の例では、 founded_yearの値が2010であるドキュメントの数をカウントします。

auto result = collection.count_documents(make_document(kvp("founded_year", 2010)));
std::cout << "Number of companies founded in 2010: " << result << std::endl;

Number of companies founded in 2010: 33

カウント動作をカスタマイズする

mongocxx::options::countクラスのインスタンスをパラメーターとして渡すことで、 count_documents()メソッドの動作を変更できます。 次の表では、 mongocxx::options::countインスタンスで設定できるフィールドを説明しています。

次の例では、 count_documents()メソッドを使用して、 number_of_employeesフィールドの値が50であるドキュメントの数をカウントし、最大100の結果をカウントするように操作に指示します。

mongocxx::options::count opts;
opts.limit(100); 
auto result = collection.count_documents(make_document(kvp("number_of_employees", 50)), opts);
std::cout << "Number of companies with 50 employees: " << result << std::endl;

Number of companies with 50 employees: 100

推定カウント動作をカスタマイズ

mongocxx::options::estimated_document_countクラスのインスタンスをパラメーターとして渡すことで、 estimated_document_count()メソッドの動作を変更できます。 次の表では、 mongocxx::options::estimated_document_countインスタンスで設定できるフィールドを説明しています。

次の例では、 estimated_document_count()メソッドを使用してコレクション内のドキュメント数の推定値を返し、最大1000ミリ秒にわたって操作を実行するように指示します。

mongocxx::options::estimated_document_count opts;
opts.max_time(std::chrono::milliseconds{1000}); 
auto result = collection.estimated_document_count(opts);
std::cout << "Estimated number of documents: " << result << std::endl;

Estimated number of documents: 9500