Delete Documents

項目一覧

Overview

サンプルデータ
削除操作
単一ドキュメントの削除
複数のドキュメントの削除
削除操作をカスタマイズする
例
詳細情報
API ドキュメント

Overview

このガイドでは、 Java Reactive Streams ドライバーを使用して、削除操作を実行し、 MongoDBコレクションからドキュメントを削除する方法を学習できます。

削除操作は、 MongoDBコレクションから 1 つ以上のドキュメントを削除します。削除操作は、 deleteOne()またはdeleteMany()メソッドを使用して実行できます。

サンプルデータ

このガイドの例では、 Atlasサンプルデータセットのsample_restaurants.restaurantsコレクションを使用します。

無料のMongoDB Atlasクラスターを作成し、サンプルデータセットをロードする方法については、「を使い始める」チュートリアルを参照してください。

重要

プロジェクトリアクターライブラリ

このガイドでは、プロジェクト Reactive ライブラリを使用して、Publisher Java Reactive Streams ドライバーメソッドによって返されたインスタンスを消費します。プロジェクト Reactor ライブラリとその使用方法の詳細については、React ドキュメントの「使用開始」を参照してください。このガイドでは Project React ライブラリメソッドをどのように使用しているかについて詳しくは、「 MongoDBへのデータの書込み」ガイドを参照してください。

削除操作

MongoDB では、次の方法で削除操作を実行できます。

deleteOne()は、検索条件に一致する最初のドキュメントを削除します。
deleteMany()は、検索条件に一致するすべてのドキュメントを削除します

各削除方法にはクエリフィルターが必要です。これは、削除対象として選択するドキュメントを決定する検索条件を指定します。クエリフィルターの詳細については、 MongoDB Serverマニュアルの「クエリフィルタードキュメント」セクションを参照してください。

単一ドキュメントの削除

MongoDBコレクションから単一ドキュメントを削除するには、 deleteOne()メソッドを呼び出し、クエリフィルターを渡します。次に、 deleteOne()の結果をMonoから静的Mono.fromメソッドに渡します。 Monoは、プロジェクト Reactor ライブラリのクラスです。 Java Reactive Streams では、ドライバーメソッドはコールドPublisherインスタンスを返します。つまり、返されたPublisherをサブスクライブしないと、対応する操作は実行されません。このガイドでは、Project Reactor ライブラリを使用してそれらを消費します。 Monoの詳細については、 MongoDB を参照してくださいプロジェクト React のドキュメントを参照してください。

次の例では、 nameの値が"Ready Penny Inn"であるドキュメントをrestaurantsコレクションから削除します。

Publisher<DeleteResult> deletePublisher = restaurants.deleteOne(
        eq("name", "Ready Penny Inn"));
Mono.from(deletePublisher).block();

複数のドキュメントの削除

MongoDBコレクションから複数のドキュメントを削除するには、 deleteMany()メソッドを呼び出し、クエリフィルターを渡します。次に、 deleteMany()の結果をMonoから静的Mono.fromメソッドに渡します。 Monoは、プロジェクト Reactor ライブラリのクラスです。 Java Reactive Streams では、ドライバーメソッドはコールドPublisherインスタンスを返します。つまり、返されたPublisherをサブスクライブしないと、対応する操作は実行されません。このガイドでは、Project Reactor ライブラリを使用してそれらを消費します。 Monoの詳細については、 MongoDB を参照してくださいプロジェクト React のドキュメントを参照してください。

次の例では、 boroughの値が"Brooklyn"であるrestaurantsコレクション内のすべてのドキュメントを排除します。

Publisher<DeleteResult> deletePublisher = restaurants.deleteMany(
        eq("borough", "Brooklyn"));
Mono.from(deletePublisher).block();

削除操作をカスタマイズする

DeleteOptionsクラスには、削除メソッドの動作を変更するメソッドが含まれています。 DeleteOptionsクラスを使用するには、クラスの新しいインスタンスを構築し、1 つ以上のそのメソッドを呼び出して削除操作を変更します。これらのメソッド呼び出しを連鎖させることができます。削除操作の動作を変更するには、クラスインスタンスと連結されたメソッド呼び出しをメソッドまたはメソッドの 2deleteOne() deleteMany()番目の引数として渡します。

削除メソッドを変更するには、 DeleteOptionsクラスの次のメソッドを使用します。すべてのメソッドは任意です。

方式	説明
`collation (Collation collation)`	Specifies the kind of language collation to use when sorting results. For more information, see Collation in the MongoDB Server manual.
`hint (Bson hint)`	Gets or sets the index to scan for documents. For more information, see the hint statement in the MongoDB Server manual.
`hint (String hint)`	Gets or sets the index to scan for documents. For more information, see the hint statement in the MongoDB Server manual.
`let (Bson variables)`	A map of parameter names and values. Values must be constant or closed expressions that don't reference document fields. For more information, see the let statement in the MongoDB Server manual.
`comment (BsonValue comment)`	A comment to attach to the operation. For more information, see the delete command fields guide in the MongoDB Server manual for more information.
`comment (String comment)`	A comment to attach to the operation. For more information, see the delete command fields guide in the MongoDB Server manual for more information.

例

次のコードでは、 deleteMany()メソッドを使用して、string "Mongo"を含むname値を持つrestaurantsコレクション内のすべてのドキュメントを削除します。また、 commentメソッドを使用して操作にコメントを追加します。

Publisher<DeleteResult> deletePublisher = restaurants.deleteMany(
        regex("name", "Mongo"),
        new DeleteOptions().comment("Deleting Mongo restaurants"));
Mono.from(deletePublisher).block();

詳細情報

Java Reactive Streams ドライバーを使用してドキュメントを挿入する実行可能なコード例については、「 MongoDBへのデータの書込み」ガイドを参照してください。

API ドキュメント

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

戻る

置換

一括書き込み (write)