Insira um documento
Você pode inserir um documento em uma coleção usando o collection.insertOne() método. Para inserir um documento, defina um objeto que contenha os campos e valores que você deseja armazenar. Se a coleção especificada não existir, o insertOne()
método criará a coleção.
Você pode especificar mais opções de query usando o parâmetro options
. Para obter mais informações sobre os parâmetros do método, consulte a documentação da API insertOne(). Para obter mais informações sobre esse método, consulte a documentação da API insertOne().
Se a operação inserir um documento com êxito, ela anexará um campo insertedId
ao objeto passado na chamada do método e definirá o valor do campo como _id
do documento inserido.
Compatibilidade
Você pode utilizar o driver Node.js para conectar e utilizar o método insertOne()
para implantações hospedadas nos seguintes ambientes:
MongoDB Atlas: o serviço totalmente gerenciado para implantações do MongoDB na nuvem
MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB
MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB
Para saber mais sobre como inserir documentos na IU do Atlas para implantações hospedadas no MongoDB Atlas, consulte Criar, Visualizar, Atualizar e Excluir Documentos.
Exemplo
Observação
Você pode utilizar este exemplo para se conectar a uma instância do MongoDB e interagir com um banco de dados que contém dados de amostra. Para saber mais sobre como se conectar à sua instância do MongoDB e carregar um conjunto de dados de amostra, consulte o guia Exemplos de uso.
1 import { MongoClient } from "mongodb"; 2 3 // Replace the uri string with your MongoDB deployment's connection string. 4 const uri = "<connection string uri>"; 5 6 // Create a new client and connect to MongoDB 7 const client = new MongoClient(uri); 8 9 async function run() { 10 try { 11 // Connect to the "insertDB" database and access its "haiku" collection 12 const database = client.db("insertDB"); 13 const haiku = database.collection("haiku"); 14 15 // Create a document to insert 16 const doc = { 17 title: "Record of a Shriveled Datum", 18 content: "No bytes, no problem. Just insert a document, in MongoDB", 19 } 20 // Insert the defined document into the "haiku" collection 21 const result = await haiku.insertOne(doc); 22 23 // Print the ID of the inserted document 24 console.log(`A document was inserted with the _id: ${result.insertedId}`); 25 } finally { 26 // Close the MongoDB client connection 27 await client.close(); 28 } 29 } 30 // Run the function and handle any errors 31 run().catch(console.dir);
1 import { MongoClient } from "mongodb"; 2 3 // Replace the uri string with your MongoDB deployment's connection string. 4 const uri = "<connection string uri>"; 5 6 const client = new MongoClient(uri); 7 8 interface Haiku { 9 title: string; 10 content: string; 11 } 12 13 async function run() { 14 try { 15 const database = client.db("insertDB"); 16 // Specifying a Schema is optional, but it enables type hints on 17 // finds and inserts 18 const haiku = database.collection<Haiku>("haiku"); 19 const result = await haiku.insertOne({ 20 title: "Record of a Shriveled Datum", 21 content: "No bytes, no problem. Just insert a document, in MongoDB", 22 }); 23 console.log(`A document was inserted with the _id: ${result.insertedId}`); 24 } finally { 25 await client.close(); 26 } 27 } 28 run().catch(console.dir);
Ao executar o exemplo anterior, você vê a seguinte saída:
A document was inserted with the _id: <your _id value>