ドキュメントの挿入

Overview

このガイドでは、MongoDB コレクションにドキュメントを挿入する方法を学習できます。

MongoDB でドキュメントを検索、更新、削除する前に、それらのドキュメントを挿入する必要があります。 メソッドを使用して 1 つのドキュメントを挿入することも、 メソッドまたはInsertOne() InsertMany()BulkWrite()メソッドを使用して複数のドキュメントを挿入することもできます。

次のセクションでは、InsertOne() と InsertMany() に焦点を当てます。

_idフィールド

MongoDB では、各ドキュメントにユニークな _id フィールドが含まれている必要があります。

このフィールドを管理するための 2 つのオプションは次のとおりです。

• このフィールドは自分で管理し、使用する各値が一意であることを確認できます。

• ドライバーが一意のObjectId値を自動的に生成できるようにします。 ドライバーは、 _idを明示的に指定していないドキュメントに対して一意のObjectId値を生成します。

一意性について強力な保証を提供しない限り、MongoDB ではドライバーに _id 値を自動的に生成させることをお勧めします。

_idフィールドの詳細については、 一意なインデックス に関するサーバー マニュアル エントリを参照してください。

ドキュメント構造とルールの詳細については、ドキュメント に関するサーバー マニュアル エントリを参照してください。

ドキュメントの挿入

単一のドキュメントをコレクションに挿入するには、InsertOne() メソッドを使用します。

挿入に成功すると、メソッドは新しいドキュメントの _id を含む InsertOneResult インスタンスを返します。

coll := client.Database("myDB").Collection("favorite_books")
doc := bson.D{{"title", "Invisible Cities"}, {"author", "Italo Calvino"}, {"year_published", 1974}}
result, err := coll.InsertOne(context.TODO(), doc)
fmt.Printf("Inserted document with _id: %v\n", result.InsertedID)

opts := options.InsertOne().SetBypassDocumentValidation(true)

複数のドキュメントの挿入

複数のドキュメントをコレクションに挿入するには、InsertMany() メソッドを使用します。

挿入に成功すると、InsertMany() メソッドは挿入されたドキュメントの _id フィールドを含む InsertManyResult インスタンスを返します。

coll := client.Database("myDB").Collection("favorite_books")
docs := []interface{}{
    bson.D{{"title", "My Brilliant Friend"}, {"author", "Elena Ferrante"}, {"year_published", 2012}},
    bson.D{{"title", "Lucy"}, {"author", "Jamaica Kincaid"}, {"year_published", 2002}},
    bson.D{{"title", "Cat's Cradle"}, {"author", "Kurt Vonnegut Jr."}, {"year_published", 1998}},
}
result, err := coll.InsertMany(context.TODO(), docs)
list_ids := result.InsertedIDs
fmt.Printf("Documents inserted: %v\n", len(list_ids))
for _, id := range list_ids {
        fmt.Printf("Inserted document with _id: %v\n", id)
}

Documents inserted: 3
Inserted document with _id: ObjectID("...")
Inserted document with _id: ObjectID("...")
Inserted document with _id: ObjectID("...")

opts := options.InsertMany().SetBypassDocumentValidation(true).SetOrdered(false)

{ "_id": 1, "country": "Tanzania" }
{ "_id": 2, "country": "Lithuania" }
{ "_id": 1, "country": "Vietnam" }
{ "_id": 3, "country": "Argentina" }

docs := []interface{}{
   bson.D{{"_id", 1}, {"country", "Tanzania"}},
   bson.D{{"_id", 2}, {"country", "Lithuania"}},
   bson.D{{"_id", 1}, {"country", "Vietnam"}},
   bson.D{{"_id", 3}, {"country", "Argentina"}},
}
result, err := coll.InsertMany(context.TODO(), docs)
list_ids := result.InsertedIDs
if err != nil {
   fmt.Printf("A bulk write error occurred, but %v documents were still inserted.\n", len(list_ids))
}
for _, id := range list_ids {
   fmt.Printf("Inserted document with _id: %v\n", id)
}

{ "_id": 1, "country": "Tanzania" }
{ "_id": 2, "country": "Lithuania" }

詳細情報

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

• ドキュメントの挿入

• 複数のドキュメントの挿入

上記の操作の実行方法の詳細については、次のガイドを参照してください。

• クエリを指定する