MongoDB में db.collection.insertOne()
विधि संग्रह में एकल दस्तावेज़ सम्मिलित करती है।
collection
दस्तावेज़ को सम्मिलित करने के लिए संग्रह का नाम भाग है।
उदाहरण
यहां pets
. नामक संग्रह में दस्तावेज़ डालने का एक उदाहरण दिया गया है :
db.pets.insertOne( {
name: "Scratch",
type: "Cat"
} )
परिणाम:
{ "acknowledged" : true, "insertedId" : ObjectId("5fe2d15637b49e0faf1af214") }
db.collection.insertOne()
विधि एक दस्तावेज़ देता है जिसमें शामिल हैं:
- एक बूलियन
acknowledged
true
. के रूप में यदि ऑपरेशन लिखित चिंता याfalse
. के साथ चलता है अगर लेखन चिंता अक्षम थी। - एक फ़ील्ड
insertedId
_id
. के साथ सम्मिलित दस्तावेज़ का मूल्य।
अब अगर हम db.collection.find()
. का उपयोग करते हैं संग्रह को देखने के लिए, हम नया जोड़ा गया दस्तावेज़ देखेंगे।
db.pets.find().pretty()
परिणाम:
{ "_id" : ObjectId("5fe2d15637b49e0faf1af214"), "name" : "Scratch", "type" : "Cat" }
मैंने pretty()
का भी इस्तेमाल किया दस्तावेज़ को प्रारूपित करने के लिए ताकि इसे पढ़ना आसान हो।
इस मामले में, हमारा दस्तावेज़ संग्रह में केवल एक ही है, और इसलिए केवल एक दस्तावेज़ लौटाया गया था।
हालांकि, अगर संग्रह बड़ा था, तो हम परिणाम को केवल इस दस्तावेज़ तक सीमित करने के लिए आईडी (रिटर्न दस्तावेज़ में प्रदान किया गया जब हमने सम्मिलित किया था) का उपयोग कर सकते थे।
db.pets.find({_id: ObjectId("5fe2d15637b49e0faf1af214")} ).pretty()
परिणाम:
{ "_id" : ObjectId("5fe2d15637b49e0faf1af214"), "name" : "Scratch", "type" : "Cat" }
यदि संग्रह मौजूद नहीं है तो क्या होगा?
यदि संग्रह मौजूद नहीं है, तो इसे बनाया जाता है, और दस्तावेज़ को इसमें जोड़ा जाता है।
यदि संग्रह पहले से मौजूद है, तो दस्तावेज़ को बस इसमें जोड़ दिया जाता है।
जब मैंने यह उदाहरण बनाया, तो संग्रह मौजूद नहीं था, और इसलिए सम्मिलित ऑपरेशन ने इसे बनाया।
द _id
फ़ील्ड
_id
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 दस्तावेज़ देखें अधिक जानकारी के लिए।