Retrieve Data

サンプル データ

このガイドの例では、 Atlas サンプル データセットのsample_restaurantsデータベースのrestaurantsコレクションを使用します。 MongoDB Atlas クラスターを無料で作成して、サンプル データセットをロードする方法については、 「 Atlas を使い始める 」ガイドを参照してください。

ドキュメントの検索の例

次の例では、mongoc_collection_find_with_opts() 関数を使用して、cuisineフィールドの値が "Spanish" であるすべてのドキュメントを検索します。

bson_t *filter = BCON_NEW ("cuisine", BCON_UTF8 ("Spanish"));
mongoc_cursor_t *results = 
    mongoc_collection_find_with_opts (collection, filter, NULL, NULL);

前の例の mongoc_collection_find_with_opts()操作は mongoc_cursor_t * を返します。これを反復処理するには、mongoc_cursor_next() 関数と を使用します。次の例では を反復処理し、前のクエリで返された結果を出力します。

const bson_t *doc;
bson_error_t error;
while (mongoc_cursor_next (results, &doc)) {
    char *str = bson_as_canonical_extended_json (doc, NULL);
    printf ("%s\n", str);
    bson_free (str);
}
// Ensure we iterated through cursor without error
if (mongoc_cursor_error (results, &error)) {
    fprintf (stderr, "Error getting results: %s\n", error.message);
}
mongoc_cursor_destroy (results);
bson_destroy (filter);

{ "_id" : { "$oid" : "..." }, "name" : "Charle'S Corner Restaurant & Deli", "cuisine" : "Spanish", ... }
{ "_id" : { "$oid" : "..." }, "name" : "Real Madrid Restaurant", "cuisine" : "Spanish", ... }
{ "_id" : { "$oid" : "..." }, "name" : "Malaga Restaurant", "cuisine" : "Spanish", ... }
{ "_id" : { "$oid" : "..." }, "name" : "Cafe Espanol", "cuisine" : "Spanish", ... }
{ "_id" : { "$oid" : "..." }, "name" : "Cafe Riazor", "cuisine" : "Spanish", ... }
...

bson_t *empty_filter = bson_new ();
mongoc_cursor_t *results = 
    mongoc_collection_find_with_opts (collection, empty_filter, NULL, NULL);
mongoc_cursor_destroy (results);
bson_destroy (empty_filter);

検索動作の変更

構成するオプションを含む bson_t 構造を渡すことで、mongoc_collection_find_with_opts() 関数の動作を変更できます。 次の表では、クエリの変更に一般的に使用されるオプションについて説明しています。

次の例では、limit と maxTimeMS オプションを使用して、クエリによって返されるドキュメント数を 10 に制限し、操作の最大実行時間を 10000 ミリ秒に設定します。

bson_t *filter = BCON_NEW ("cuisine", BCON_UTF8 ("Spanish"));
bson_t *opts = BCON_NEW ("limit", BCON_INT32 (10), "maxTimeMS", BCON_INT32 (10000));
mongoc_cursor_t *results = 
    mongoc_collection_find_with_opts (collection, filter, opts, NULL);
mongoc_cursor_destroy (results);
bson_destroy (filter);
bson_destroy (opts);

の動作を変更するオプションの完全なリストについては、 mongoc_collection_find_with_opts()MongoDB Serverマニュアルの find メソッドのドキュメントを参照してください。

API ドキュメント

このガイドで説明されている関数の詳細については、次のAPIドキュメントを参照してください。

• mongoc_collection_find_with_opts()