MongoDB insertOne（）

MongoDBでは、db.collection.insertOne() メソッドは、単一のドキュメントをコレクションに挿入します。

collection partは、ドキュメントを挿入するコレクションの名前です。

例

petsというコレクションにドキュメントを挿入する例を次に示します。：

db.pets.insertOne( { 
    name: "Scratch", 
    type: "Cat" 
    } )

結果：

{
	"acknowledged" : true,
	"insertedId" : ObjectId("5fe2d15637b49e0faf1af214")
}

db.collection.insertOne() メソッドは以下を含むドキュメントを返します：

ここで、db.collection.find()を使用するとコレクションを見ると、新しく追加されたドキュメントが表示されます。

db.pets.find().pretty()

結果：

{
	"_id" : ObjectId("5fe2d15637b49e0faf1af214"),
	"name" : "Scratch",
	"type" : "Cat"
}

pretty()も使用しました読みやすくするためにドキュメントをフォーマットします。

この場合、コレクション内のドキュメントは1つだけであるため、返されたドキュメントは1つだけです。

ただし、コレクションが大きい場合は、ID（挿入時にリターンドキュメントで提供されたもの）を使用して、結果をこのドキュメントのみに絞り込むことができます。

db.pets.find({_id: ObjectId("5fe2d15637b49e0faf1af214")} ).pretty()

結果：

{
	"_id" : ObjectId("5fe2d15637b49e0faf1af214"),
	"name" : "Scratch",
	"type" : "Cat"
}

コレクションが存在しない場合は、コレクションが作成され、ドキュメントがコレクションに追加されます。

コレクションがすでに存在する場合は、ドキュメントがコレクションに追加されるだけです。

この例を作成したとき、コレクションは存在しなかったため、挿入操作で作成されました。

_id fieldは、MongoDBの一意の識別子フィールドです。

独自の_idを提供できますドキュメントのフィールド。その場合、その値はコレクション内で一意である必要があります。これは、_idが原因ですフィールドは、ドキュメントの一意の識別子として使用されます。

独自の_idを持つドキュメントを挿入する例を次に示します。フィールド。

db.pets.insertOne( { 
    _id: 1,
    name: "Fetch", 
    type: "Dog" 
    } )

結果：

{ "acknowledged" : true, "insertedId" : 1 }

それでは、コレクションをもう一度見てみましょう。

db.pets.find()

結果：

{ "_id" : ObjectId("5fe2d15637b49e0faf1af214"), "name" : "Scratch", "type" : "Cat" }
{ "_id" : 1, "name" : "Fetch", "type" : "Dog" }

db.collection.insertOne() メソッドはwriteConcernも受け入れます引数。書き込み操作のためにMongoDBから要求される確認応答のレベルを説明します。

db.collection.insertOne()については、MongoDBのドキュメントを参照してください。詳細については。