Delete Documents

Overview

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

サンプルデータ

このガイドの例えでは、books コレクション内のドキュメントのモデルとして次の Book 構造体を使用しています。

type Book struct {	Title  string	Author string	Length int32}

このガイドの例を実行するには、次のスニペットを使用してサンプルデータを db.books コレクションにロードします。

coll := client.Database("db").Collection("books")docs := []any{	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()`	削除するドキュメントをスキャンするために使用するインデックス。デフォルト: `nil`
`SetCollation()`	結果をソートするときに使用する言語照合のタイプ。デフォルト: `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)

Tip

上記の例でDeleteMany()ではなくDeleteOne()メソッドが使用されている場合、ドライバーは一致した 2 つのドキュメントのうちの最初のドキュメントを削除します。

DeleteOne() の例: 完全なファイル

注意

セットアップ例

この例では、接続 URI を使用して MongoDB インスタンスに接続します。MongoDB インスタンスへの接続の詳細については、「MongoClient の作成」を参照してください。この例では、Atlas サンプルデータセットに含まれる sample_restaurants データベースの restaurants コレクションも使用します。「Atlas スタートガイド」の手順に従って、MongoDB Atlas の無料クラスターのデータベースにロードできます。

次の例は、restaurantsコレクション内の既存のドキュメントを検索して削除する完全に実行可能なファイルです。

// Deletes a document from a collection by using the Go driverpackage main
import (	"context"	"fmt"	"log"	"os"
	"github.com/joho/godotenv"	"go.mongodb.org/mongo-driver/v2/bson"	"go.mongodb.org/mongo-driver/v2/mongo"	"go.mongodb.org/mongo-driver/v2/mongo/options")
// Defines a Restaurant struct as a model for documents in the "restaurants" collectiontype Restaurant struct {	ID      bson.ObjectID `bson:"_id"`	Name    string        `bson:"name"`	Cuisine string        `bson:"cuisine,omitempty"`	Address interface{}   `bson:"address,omitempty"`	Borough string        `bson:"borough,omitempty"`	Grades  []interface{} `bson:"grades,omitempty"`}
func main() {	if err := godotenv.Load(); err != nil {		log.Println("No .env file found")	}
	var uri string	if uri = os.Getenv("MONGODB_URI"); uri == "" {		log.Fatal("You must set your 'MONGODB_URI' environment variable. See\n\t https://www.mongodb.com/ja-jp/docs/drivers/go/current/connect/mongoclient/#environment-variable")	}
	client, err := mongo.Connect(options.Client().ApplyURI(uri))	if err != nil {		panic(err)	}	defer func() {		if err = client.Disconnect(context.TODO()); err != nil {			panic(err)		}	}()
	coll := client.Database("sample_restaurants").Collection("restaurants")	filter := bson.D{{"name", "New Corner"}}
	// Deletes the first document that has a "name" value of "New Corner"	result, err := coll.DeleteOne(context.TODO(), filter)
	// Prints a message if any errors occur during the operation	if err != nil {		panic(err)	}
	// Prints the number of deleted documents	fmt.Printf("Documents deleted: %d\n", result.DeletedCount)
	// When you run this file for the first time, it prints output similar to the following:	// Documents deleted: 1}

DeleteMany() の例: 完全なファイル

注意

セットアップ例

次の例は、restaurantsコレクションに対して次のアクションを実行する完全に実行可能なファイルです。

cuisineフィールド値が German であり、boroughフィールド値が Queens であるドキュメントを照合して削除します
一致するドキュメントをすべて削除します

// Deletes multiple documents from a collection by using the Go driverpackage main
import (	"context"	"fmt"	"log"	"os"
	"github.com/joho/godotenv"	"go.mongodb.org/mongo-driver/v2/bson"	"go.mongodb.org/mongo-driver/v2/mongo"	"go.mongodb.org/mongo-driver/v2/mongo/options")
// Defines a Restaurant struct as a model for documents in the "restaurants" collectiontype Restaurant struct {	ID      bson.ObjectID `bson:"_id"`	Name    string        `bson:"name"`	Borough string        `bson:"borough"`	Cuisine string        `bson:"cuisine"`}
func main() {	if err := godotenv.Load(); err != nil {		log.Println("No .env file found")	}
	var uri string	if uri = os.Getenv("MONGODB_URI"); uri == "" {		log.Fatal("You must set your 'MONGODB_URI' environment variable. See\n\t https://www.mongodb.com/ja-jp/docs/drivers/go/current/connect/mongoclient/#environment-variable")	}
	client, err := mongo.Connect(options.Client().ApplyURI(uri))	if err != nil {		panic(err)	}	defer func() {		if err = client.Disconnect(context.TODO()); err != nil {			panic(err)		}	}()
	coll := client.Database("sample_restaurants").Collection("restaurants")	filter := bson.D{		{"borough", "Queens"},		{"cuisine", "German"},	}
	// Deletes all documents that have a "Borough" value of "Queens" and a "Cuisine" value of "German"	results, err := coll.DeleteMany(context.TODO(), filter)	if err != nil {		panic(err)	}
	// Prints the number of deleted documents	fmt.Printf("Documents deleted: %d\n", results.DeletedCount)
	// When you run this file for the first time, it prints output similar to the following:	// Documents deleted: 6}