ドキュメントの置換

サンプル データ

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

必要なパラメーター

mongoc_collection_replace_one() 関数には次のパラメータが必要です。

• コレクション: 置換操作 を実行するコレクションを指定します。

• クエリフィルタードキュメント: 一致するコレクションドキュメントを指定します。 この関数は、置き換えが最初に一致するドキュメントを選択します。 クエリフィルターの詳細については、 MongoDB Serverマニュアルの「 クエリフィルター ドキュメント 」セクションを参照してください。

• 置換ドキュメント: 新しいドキュメントに挿入するフィールドと値を指定します。

• オプションドキュメント:操作をカスタマイズするためのオプション または NULL を指定します。

• 結果のロケーション:操作結果を含む上書き可能なストレージへのポインター、または NULL を指定します。

• エラー ロケーション: エラー値または NULL のロケーションを指定します。

例

次の例では、 mongoc_collection_replace_one() 関数を使用して、nameフィールドの値が "Pizza Town" であるドキュメントのフィールドと値を、nameフィールドの値が "Mongo's Pizza" であるドキュメントに置き換えます。

bson_t *query = BCON_NEW("name", "Pizza Town");
bson_t *replace = BCON_NEW(
    "name", "Mongo's Pizza",
    "cuisine", "Pizza",
    "address", "{",
    "street", "123 Pizza St",
    "zipCode", "10003",
    "}",
    "borough", "Manhattan"
);
bson_error_t error;
if (!mongoc_collection_replace_one(collection, query, replace, NULL, NULL, &error)) {
    fprintf(stderr, "Replace operation failed: %s\n", error.message);
}
bson_destroy(query);
bson_destroy(replace);

置き換えオプションの例

次のコードでは、mongoc_collection_replace_one() 関数を使用して、nameフィールドの値が "Food Town" である最初のドキュメントを見つけ、このドキュメントをname の値が "Food World" である新しいドキュメントに置き換えます。 upsert オプションが true に設定されているため、クエリフィルターが既存のドキュメントと一致しない場合、ドライバーは新しいドキュメントを挿入します。

bson_t *query = BCON_NEW("name", "Food Town");
bson_t *replace = BCON_NEW(
    "name", "Food World",
    "cuisine", "Mixed",
    "address", "{",
    "street", "123 Food St",
    "zipCode", "10003",
    "}",
    "borough", "Manhattan"
);
bson_error_t error;
bson_t opts;
bson_init(&opts);
bson_append_bool(&opts, "upsert", -1, true);
if (!mongoc_collection_replace_one(collection, query, replace, &opts, NULL, &error)) {
    fprintf(stderr, "Replace operation failed: %s\n", error.message);
} 
bson_destroy(query);
bson_destroy(replace);
bson_destroy(&opts);

API ドキュメント

mongoc_collection_replace_one() 関数の詳細については、APIドキュメントを参照してください。