Retrieve Data

サンプル データ

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

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

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

1 つのドキュメントの検索

コレクション内の 1 つのドキュメントを検索するには、 find_one()メソッドを呼び出し、検索するドキュメントの基準を指定するクエリフィルターを渡します。

find_one()メソッドはstd::optional< bsoncxx::document::value >のインスタンスを返します。 クエリフィルターがドキュメントと一致する場合、 optionalオブジェクトにはbsoncxx::document::value型の値が含まれます。 クエリフィルターがどのドキュメントにも一致しない場合、 optionalオブジェクトには値が含まれません。

クエリフィルターが複数のドキュメントに一致する場合、 find_one()メソッドは検索した結果から最初に一致するドキュメントを返します。

次の例では、 find_one()メソッドを使用して、 nameフィールドの値が"LinkedIn"になっている最初のドキュメントを検索します。

auto result = collection.find_one(make_document(kvp("name", "LinkedIn")));
std::cout << bsoncxx::to_json(*result) << std::endl;

{ "_id" : { "$oid" : "52cdef7c4bab8bd675297e0c" }, "name" : "LinkedIn", "permalink" : "linkedin",
"crunchbase_url" : "http://www.crunchbase.com/company/linkedin", "homepage_url" : "http://linkedin.com",
...

並べ替えについて詳しくは、「 返すドキュメントを指定する 」ガイドの「並べ替え」セクションを参照してください。

複数ドキュメントの検索

コレクション内の複数のドキュメントを検索するには、検索するドキュメントの基準を指定するクエリフィルターを find() メソッドに渡します。

次の例では、 find()メソッドを使用して、 founded_yearフィールドの値が1970であるすべてのドキュメントを検索します。

auto cursor = collection.find(make_document(kvp("founded_year", 1970)));

find()メソッドはmongocxx::cursorのインスタンスを返します。これを反復処理して一致するドキュメントを確認できます。 カーソルは、アプリケーションがデータベースの結果を反復処理しながら、特定の時点でメモリ内に結果のサブセットのみを保持できるようにするメカニズムです。 カーソルは、 find()メソッドが大量のドキュメントを返す場合に便利です。

次の例に示すように、 for-inループを使用して、カーソル内のドキュメントを反復処理できます。

auto cursor = collection.find(make_document(kvp("founded_year", 1970)));
for(auto&& doc : cursor) {
    std::cout << bsoncxx::to_json(doc) << std::endl;
}

{ "_id" : { "$oid" : "52cdef7d4bab8bd675298be4" }, "name" : "Mitsubishi Motors",
"permalink" : "mitsubishi-motors", "crunchbase_url" : "http://www.crunchbase.com/company/mitsubishi-motors",
...
{ "_id" : { "$oid" : "52cdef7e4bab8bd67529b996" }, "name" : "Western Digital",
"permalink" : "western-digital", "crunchbase_url" : "http://www.crunchbase.com/company/western-digital",
...
{ "_id" : { "$oid" : "52cdef7e4bab8bd67529b9f1" }, "name" : "Celarayn", "permalink" : "celarayn",
"crunchbase_url" : "http://www.crunchbase.com/company/celarayn",
...

auto cursor = collection.find({})

検索動作の変更

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

次の例では、 find()メソッドを使用して、 number_of_employeesフィールドの値が1000であるすべてのドキュメントを検索し、最大5の結果を返すように操作に指示します。

mongocxx::options::find opts;
opts.limit(5);
auto cursor = collection.find(make_document(kvp("number_of_employees", 1000)), opts);

mongocxx::options::findオブジェクトフィールドの完全なリストについては、 APIドキュメントを参照してください。

API ドキュメント

このガイドで説明したメソッドや型の詳細については、次の API ドキュメントを参照してください。

• find()

• find_one()

• limit()