AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

Delete Documents

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

このガイドには、次のセクションが含まれています。

  • サンプル データの例では、削除操作の例で使用されるサンプル データが示されています

  • 「削除操作」では、ドライバーを使用して削除操作を実行する方法について説明します

  • 追加情報では、このガイドで言及されている型とメソッドのリソースとAPIドキュメントへのリンクを提供します

このガイドの例では、次のサンプル ドキュメントを使用します。 各ドキュメントは、店舗の在庫内の商品を表し、その分類と単価に関する情報が含まれています。

{ "item": "trowel", "category": "garden", "unit_price": 9.89 },{ "item": "placemat", "category": "kitchen", "unit_price": 3.19 },{ "item": "watering can", "category": "garden", "unit_price": 11.99 }

Rust ドライバーは、削除操作を実行するための メソッドとdelete_one() delete_many()メソッドを提供します。

delete_one()メソッドとdelete_many()メソッドは、クエリフィルターをパラメーターとして受け取ります。 クエリフィルターは、一致するドキュメントの基準を形成するフィールドと値で構成されます。

オプションで、どちらのメソッドにもパラメーターとしてDeleteOptions型を渡すこともできます。 削除操作を構成するには、 DeleteOptionsインスタンスで 設定を指定します。 各設定でデフォルト値を使用するには、オプション パラメータとして値Noneを指定します。

注意

インスタンス化オプション

Rust ドライバーは、 DeleteOptionsを含む多くのさまざまなタイプを作成するためのビルダ設計パターンを実装します。 各タイプのbuilder()メソッドを使用して、オプション ビルダー関数を 1 つずつ連鎖させてオプション インスタンスを構築できます。

次の表では、 DeleteOptionsインスタンスで指定できる設定について説明しています。

オプション
説明

collation

結果をソートするときに使用する照合。照合について詳しくは、「照合」ガイドを参照してください。

タイプ: Collation
デフォルト: None

write_concern

操作の書込み保証 (write concern)。このオプションを設定しない場合、操作はコレクションに設定された書込み保証 (write concern)を継承します。書込み保証 (write concern) の詳細については、サーバー マニュアルの「書込み保証(write concern) 」を参照してください。

タイプ: WriteConcern

hint

操作に使用するインデックス。インデックスの詳細については、サーバー マニュアルの「インデックス」を参照してください。このオプションは、MongoDB Server バージョン 4.4 以降に接続した場合にのみ使用できます。

タイプ: Hint
デフォルト: None

let_vars

パラメーターと値のマップ。これらのパラメーターは、集計式の変数としてアクセスできます。このオプションは、MongoDB Server バージョン 5.0 以降に接続する場合にのみ利用できます。

タイプ: Document

comment

データベースプロファイラー、currentOp、およびログを介して操作をトレースするための任意の Bson 値。このオプションは、MongoDB Server バージョン 4.4 以降に接続した場合にのみ使用できます。

タイプ: Bson
デフォルト: None

次のコードは、 DeleteOptionsインスタンスを構築し、それをdelete_one()メソッドに渡す方法を示しています。

let opts: DeleteOptions = DeleteOptions::builder().comment(bson!("hello!")).build();let res = my_coll.delete_one(filter, opts).await?;

delete_one()メソッドとdelete_many()メソッドはDeleteResult型を返します。 このタイプには、削除されたドキュメント数を示すdeleted_countプロパティが含まれています。 指定したクエリフィルターに一致するドキュメントがない場合、削除操作によってドキュメントは削除されず、 deleted_countの値は0になります。

以下の例では、次のパラメータを使用してdelete_many()メソッドを呼び出す方法を示しています。

  • categoryの値が"garden"であるドキュメントに一致するクエリフィルター

  • 削除操作のヒントとして_id_インデックスを使用するDeleteOptionsインスタンス

let filter = doc! { "category": "garden" };let hint = Hint::Name("_id_".to_string());let opts: DeleteOptions = DeleteOptions::builder().hint(hint).build(); let res = my_coll.delete_many(filter, opts).await?;println!("Deleted documents: {}", res.deleted_count);

注意

上記のコード例でdelete_many()ではなくdelete_one()メソッドを使用すると、ドライバーはクエリフィルターに一致する 2 つのドキュメントのうち最初のドキュメントのみを削除します。

削除操作の実行可能な例については、次の使用例を参照してください。

このガイドの操作の詳細については、次のドキュメントを参照してください。

このガイドで言及されているメソッドとタイプの詳細については、次のAPIドキュメントを参照してください。