Delete Documents
Overview
このガイドでは、削除操作を使用して MongoDB コレクションからドキュメントを削除する方法を学習できます。
サンプル データ
このガイドの例では、books コレクション内のドキュメントのモデルとして次の Book 構造体を使用しています。
type Book struct { Title string Author string Length int32 }
このガイドの例を実行するには、次のスニペットを使用してサンプルデータを db.books コレクションにロードします。
coll := client.Database("db").Collection("books") docs := []interface{}{ Book{Title: "Atonement", Author: "Ian McEwan", Length: 351}, Book{Title: "My Brilliant Friend", Author: "Elena Ferrante", Length: 331}, Book{Title: "Lucy", Author: "Jamaica Kincaid", Length: 103}, Book{Title: "Outline", Author: "Rachel Cusk", Length: 258}, } result, err := coll.InsertMany(context.TODO(), docs)
各ドキュメントには書籍の説明が含まれており、各ドキュメントのtitle 、 author 、 lengthフィールドに対応するタイトル、著者、ページ長が含まれています。
Tip
存在しないデータベースとコレクション
書き込み操作を実行するときに必要なデータベースとコレクションが存在しない場合は、サーバーが暗黙的にそれらを作成します。
削除操作
削除操作を使用して、MongoDB からデータを削除します。 削除操作は、次の方法で構成されています。
DeleteOne()は、フィルターに一致する最初のドキュメントを削除します。DeleteMany()は、フィルターに一致するすべてのドキュメントを削除します
Tip
DeleteMany()メソッドの実行時にフィルターに一致するドキュメントが 1 つある場合は、 DeleteOne()メソッドを実行するのと同じです。
パラメーター
DeleteOne()メソッドとDeleteMany()メソッドでは、一致するドキュメントを指定するContextタイプとnon-nilクエリフィルターを渡すことが想定されています。
オプションとして、これらはどちらも削除操作を構成するために使用できるオプションを表す 3 つ目のパラメータとしてDeleteOptionsタイプを指定します。 DeleteOptionsを指定しない場合、ドライバーは各オプションのデフォルト値を使用します。
DeleteOptions タイプでは、次の方法でオプションを設定できます。
方式 | 説明 |
|---|---|
SetHint() | The index to use to scan for documents to delete. Default: nil |
SetCollation() | The type of language collation to use when sorting results. Default: nil |
戻り値
DeleteOne()メソッドとDeleteMany()メソッドはDeleteResult型を返します。 このタイプには、削除されたドキュメント数を示すDeletedCountプロパティが含まれています。 If there are no matches to your filter, no document gets deleted and DeletedCount is 0.
例
次の例では、 DeleteMany()メソッドを使用して次の操作を実行します。
lengthが300を超えるドキュメントを照合して削除しますインデックスとして
_idを使用するようにメソッドに指示します
filter := bson.D{{"length", bson.D{{"$gt", 300}}}} opts := options.Delete().SetHint(bson.D{{"_id", 1}}) result, err := coll.DeleteMany(context.TODO(), filter, opts) if err != nil { panic(err) } fmt.Printf("Number of documents deleted: %d\n", result.DeletedCount)
Number of documents deleted: 2
Tip
上記の例でDeleteMany()ではなくDeleteOne()メソッドが使用されている場合、ドライバーは一致した 2 つのドキュメントのうちの最初のドキュメントを削除します。
詳細情報
削除操作の実行可能な例については、次の使用例を参照してください。
上記の操作の実行方法の詳細については、次のガイドを参照してください。
ドライバーが Context を使用する方法について詳しくは、「 Context 」を参照してください。
ヒントの指定の詳細については、「インデックス 」を参照してください。
照合の詳細については、「照合 」を参照してください。
API ドキュメント
このガイドで説明したメソッドや型の詳細については、次の API ドキュメントを参照してください。