Bulk.find.update()

説明

Bulk.find.update(<update>)

一括操作リストに multi アップデート操作を追加します。このメソッドは、既存のドキュメントの特定のフィールドをアップデートします。

Bulk.find()メソッドを使用して、アップデートするドキュメントを決定する条件を指定します。 Bulk.find.update()メソッドは、一致するすべてのドキュメントをアップデートします。 1 つのドキュメントのアップデートを指定するには、 Bulk.find.updateOne()を参照してください。

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

Parameter	タイプ	説明
update	ドキュメントまたはパイプライン	適用される変更内容。次のいずれかになります。 Update document 更新演算子式のみが含まれます。 Aggregation Pipeline 次の集計ステージのみが含まれます。 $addFields およびそのエイリアス $set $project およびそのエイリアス $unset $replaceRootとそのエイリアス$replaceWith 。 update 変更パラメーターの詳細については、db.collection.updateMany() のリファレンス ページを参照してください。 Bulk.find() からの関連 <query> ドキュメントと更新ドキュメントの合計は、BSON ドキュメントの最大サイズ以下である必要があります。

• この操作について upsert: true を指定するには、 Bulk.find.upsert()を使用します。Bulk.find.upsert()では、 Bulk.find()クエリ条件に一致するドキュメントがない場合、アップデート操作によって 1 つのドキュメントのみが挿入されます。

• 特定の配列要素を更新するためにarrayFiltersを指定するには、 Bulk.find.arrayFilters()とともに使用します。

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

• ドキュメントをまとめて置換するには、Bulk.find.replaceOne() を参照してください。

例

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

var bulk = db.items.initializeUnorderedBulkOp();
bulk.find( { status: "D" } ).update( { $set: { status: "I", points: "0" } } );
bulk.find( { item: null } ).update( { $set: { item: "TBD" } } );
bulk.execute();

var bulk = db.items.initializeUnorderedBulkOp();
bulk.find( { status: "P" } ).update(
   [
      { $set: { points: 0, lastModified: "$$NOW" } }
   ]
);
bulk.execute();