Bulk.find.replaceOne()

項目一覧

説明

互換性
例

Tip

MongoDB は、一括書込み操作を実行するための db.collection.bulkWrite() メソッドも提供します。

説明

Bulk.find.replaceOne(<document>)

一括操作リストに 1 つのドキュメント置換操作を追加します。 Bulk.find()メソッドを使用して、置き換えるドキュメントを決定する条件を指定します。 Bulk.find.replaceOne()メソッドは、置換を 1 つのドキュメントに制限します。

Bulk.find.replaceOne() は、次のパラメーターを受け入れます。

Parameter	タイプ	説明
`replacement`	ドキュメント	既存のドキュメントを完全に置き換える置換ドキュメント。フィールドと値のペアのみが含まれます。 `Bulk.find()`からの関連する`<query>`ドキュメントと置換ドキュメントの合計は、 BSON ドキュメントの最大サイズ以下である必要があります。

この操作のアップサートを指定するには、 Bulk.find.upsert()を参照してください。

関連する Bulk.find() に使用するインデックスを指定するには、Bulk.find.hint()を参照してください。

互換性

このコマンドは、次の環境でホストされている配置で使用できます。

MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージドサービスです

注意

このコマンドは、すべての MongoDB Atlas クラスターでサポートされています。すべてのコマンドに対する Atlas のサポートについては、「サポートされていないコマンド」を参照してください。

例

次の例では、 itemsコレクションでBulk()操作ビルダを初期化し、さまざまなreplaceOne()操作を操作リストに追加します。

var bulk = db.items.initializeUnorderedBulkOp();
bulk.find( { item: "abc123" } ).replaceOne( { item: "abc123", status: "P", points: 100 } );
bulk.execute();

Tip

以下も参照してください。

戻る

Bulk.find.removeOne

Bulk.find.updateOne