Di MongoDB db.collection.insertOne()
metode menyisipkan satu dokumen ke dalam koleksi.
collection
bagian adalah nama koleksi untuk memasukkan dokumen ke dalamnya.
Contoh
Berikut adalah contoh memasukkan dokumen ke dalam koleksi yang disebut pets
:
db.pets.insertOne( {
name: "Scratch",
type: "Cat"
} )
Hasil:
{ "acknowledged" : true, "insertedId" : ObjectId("5fe2d15637b49e0faf1af214") }
db.collection.insertOne()
metode mengembalikan dokumen yang berisi:
- Boolean
acknowledged
sebagaitrue
jika operasi berjalan dengan masalah tulis ataufalse
jika masalah penulisan dinonaktifkan. - Bidang
insertedId
dengan_id
nilai dokumen yang disisipkan.
Sekarang jika kita menggunakan db.collection.find()
untuk melihat koleksinya, kita akan melihat dokumen yang baru ditambahkan.
db.pets.find().pretty()
Hasil:
{ "_id" : ObjectId("5fe2d15637b49e0faf1af214"), "name" : "Scratch", "type" : "Cat" }
Saya juga menggunakan pretty()
untuk memformat dokumen agar lebih mudah dibaca.
Dalam hal ini, dokumen kami adalah satu-satunya dalam koleksi, sehingga hanya satu dokumen yang dikembalikan.
Namun, jika koleksinya besar, kami dapat menggunakan ID (tersedia di dokumen pengembalian saat kami melakukan penyisipan) untuk mempersempit hasilnya menjadi dokumen ini saja.
db.pets.find({_id: ObjectId("5fe2d15637b49e0faf1af214")} ).pretty()
Hasil:
{ "_id" : ObjectId("5fe2d15637b49e0faf1af214"), "name" : "Scratch", "type" : "Cat" }
Bagaimana jika Koleksi Tidak Ada?
Jika koleksi tidak ada, itu dibuat, dan dokumen ditambahkan ke dalamnya.
Jika koleksi sudah ada, maka dokumen cukup ditambahkan ke dalamnya.
Saat saya membuat contoh ini, koleksinya tidak ada, jadi operasi penyisipan yang membuatnya.
_id
Bidang
_id
bidang adalah bidang pengenal unik di MongoDB.
Anda dapat memberikan _id
Anda sendiri lapangan dalam dokumen. Jika ya, maka nilainya harus unik di dalam koleksi. Ini karena _id
your Anda kolom akan digunakan sebagai pengidentifikasi unik dokumen.
Berikut ini contoh penyisipan dokumen dengan _id
-nya sendiri lapangan.
db.pets.insertOne( {
_id: 1,
name: "Fetch",
type: "Dog"
} )
Hasil:
{ "acknowledged" : true, "insertedId" : 1 }
Sekarang mari kita lihat lagi koleksinya.
db.pets.find()
Hasil:
{ "_id" : ObjectId("5fe2d15637b49e0faf1af214"), "name" : "Scratch", "type" : "Cat" } { "_id" : 1, "name" : "Fetch", "type" : "Dog" }
Informasi Lebih Lanjut
db.collection.insertOne()
metode ini juga menerima writeConcern
argumen, yang menjelaskan tingkat pengakuan yang diminta dari MongoDB untuk operasi tulis.
Lihat dokumentasi MongoDB untuk db.collection.insertOne()
untuk informasi lebih lanjut.