返すフィールドを指定する

項目一覧

Overview

サンプルデータ
プロジェクションのタイプ
含めるフィールドの指定
_idフィールドを除外する
詳細情報
API ドキュメント

Overview

このガイドでは、プロジェクションを使用して、読み取り操作から返されるフィールドを指定する方法を学習できます。プロジェクションは、MongoDB がクエリから返すフィールドを指定するドキュメントです。

サンプルデータ

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

プロジェクションのタイプ

プロジェクションを使用して、返されるドキュメントに含めるフィールドを指定したり、除外するフィールドを指定したりできます。

プロジェクションに含める特定のフィールドを指定すると、他のすべてのフィールドは暗黙的に除外されます（デフォルトで含まれる_idフィールドを除く）。 _idフィールドを除外しない限り、1 つのプロジェクションに包含ステートメントと除外ステートメントを組み合わせることはできません。

返されたドキュメントから_idフィールドを削除するには、明示的に除外する必要があります。

含めるフィールドの指定

次の例では、mongoc_collection_find_with_opts() 関数を使用して、nameフィールドの値が "Emerald Pub" であるすべてのレストランを検索します。これは、mongoc_collection_find_with_opts() のオプションパラメータを使用して、返されたドキュメントの name 、cuisine 、および borough フィールドのみを返すプロジェクションを指定します。

const bson_t *doc;
bson_t *filter = BCON_NEW ("name", BCON_UTF8 ("Emerald Pub"));
bson_t *opts = BCON_NEW ("projection", "{",
                    "name", BCON_BOOL (true),
                    "cuisine", BCON_BOOL (true),
                    "borough", BCON_BOOL (true),
                    "}");
mongoc_cursor_t *results = 
    mongoc_collection_find_with_opts (collection, filter, opts, NULL);
while (mongoc_cursor_next (results, &doc)) {
    char *str = bson_as_canonical_extended_json (doc, NULL);
    printf ("%s\n", str);
    bson_free (str);
}
bson_destroy (filter);
bson_destroy (opts);
mongoc_cursor_destroy (results);

{ "_id" : { "$oid" : "..." }, "borough" : "Manhattan", "cuisine" : "American", "name" : "Emerald Pub" }
{ "_id" : { "$oid" : "..." }, "borough" : "Queens", "cuisine" : "American", "name" : "Emerald Pub" }

フィールドを除外する`_id`

含めるフィールドを指定する場合は、返されるドキュメントから_idフィールドを除外することもできます。

次の例では、前の例と同じクエリを実行しますが、プロジェクションから_idフィールドを除外しています。

const bson_t *doc;
bson_t *filter = BCON_NEW ("name", BCON_UTF8 ("Emerald Pub"));
bson_t *opts = BCON_NEW ("projection", "{",
                    "name", BCON_BOOL (true),
                    "cuisine", BCON_BOOL (true),
                    "borough", BCON_BOOL (true),
                    "_id", BCON_BOOL (false),
                    "}");
mongoc_cursor_t *results = 
    mongoc_collection_find_with_opts (collection, filter, opts, NULL);
while (mongoc_cursor_next (results, &doc)) {
    char *str = bson_as_canonical_extended_json (doc, NULL);
    printf ("%s\n", str);
    bson_free (str);
}
bson_destroy (filter);
bson_destroy (opts);
mongoc_cursor_destroy (results);

{ "borough" : "Manhattan", "cuisine" : "American", "name" : "Emerald Pub" }
{ "borough" : "Queens", "cuisine" : "American", "name" : "Emerald Pub" }

詳細情報

プロジェクションの詳細については、MongoDB Server マニュアルのプロジェクトフィールドガイドを参照してください。

API ドキュメント

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

mongoc_collection_find_with_opts()

戻る

Retrieve Data

返すドキュメントを指定する