Visão geral
Neste guia, você aprenderá como inserir documentos no MongoDB.
Você pode usar o MongoDB para recuperar, atualizar e excluir informações que já estão armazenadas no MongoDB. Para armazenar informações, use uma operação de inserção.
Uma operação de inserção insere um ou mais documentos em uma coleção MongoDB. O driver Node.js fornece os seguintes métodos para executar operações de inserção :
insertOne()insertMany()bulkWrite()
Dica
Laboratório interativo
Esta página inclui um breve laboratório interativo que demonstra como inserir dados usando o método insertOne(). Você pode concluir este laboratório diretamente na janela do seu navegador sem instalar o MongoDB ou um editor de código.
Para iniciar o laboratório, clique no botão Open Interactive Tutorial na parte superior da página. Para expandir o laboratório para um formato de tela inteira, clique no botão de tela inteira (⛶) no canto superior direito do painel do laboratório.
As seções a seguir focam em insertOne() e insertMany(). Para obter um exemplo de como usar o método bulkWrite(), consulte a seção Exemplo de BulkWrite(): Arquivo Completo do guia Operações em Massa.
Uma observação sobre _id
Ao inserir um documento, o MongoDB impõe uma restrição nos seus documentos por padrão. Cada documento deve conter um campo _id exclusivo.
Há duas maneiras de gerenciar este campo:
Você mesmo pode gerenciar esse campo, garantindo que cada valor usado seja exclusivo.
Você pode permitir que o driver gere automaticamente valores únicos de
ObjectIdcom a fábrica de chaves primárias.
A menos que você tenha fornecido garantias sólidas de exclusividade, recomendamos que deixe o driver gerar automaticamente os valores de _id.
Observação
Os valores _id duplicados violam restrições de índice único, resultando em um WriteError.
Para obter mais informações sobre _id, consulte a entrada do manual do servidor sobre Índices únicos.
Inserir um único documento
Use o método insertOne() quando quiser inserir um único documento.
Em uma inserção bem-sucedida, o método retorna uma instância do InsertOneResult representando o _id do novo documento.
Exemplo
O exemplo a seguir usa o método insertOne() para inserir um novo documento na coleção myDB.pizzaMenu:
const myDB = client.db("myDB");const myColl = myDB.collection("pizzaMenu");
const doc = { name: "Neapolitan pizza", shape: "round" };const result = await myColl.insertOne(doc);console.log( `A document was inserted with the _id: ${result.insertedId}`,);Sua saída se assemelha ao seguinte texto:
A document was inserted with the _id: 60c79c0f4cc72b6bb31e3836Para obter mais informações sobre as classes e métodos mencionados nesta seção, consulte os seguintes recursos:
Documentação da API do insertOne()
Documentação da API sobre InsertOneResult
Entrada manual do servidor em insertOne()
insertOne() Exemplo: arquivo completo
Observação
Exemplo de configuração
Esse exemplo se conecta a uma instância do MongoDB usando um URI de conexão. Para saber mais sobre como se conectar à sua instância do MongoDB, consulte o Guia de conexão. Este exemplo também usa a coleção movies no banco de dados sample_mflix incluído nos conjuntos de dados de amostra do Atlas. Você pode carregá-los em seu banco de dados em um cluster gratuito no MongoDB Atlas seguindo o MongoDB Get Started.
O código a seguir é um arquivo completo e autônomo que executa uma operação de inserção :
import { MongoClient } from "mongodb";
// Replace the uri string with your MongoDB deployment's connection string.const uri = "<connection string uri>";
// Create a new client and connect to MongoDBconst client = new MongoClient(uri);
async function run() { try { // Connect to the "sample_mflix" database and access its "movies" collection const database = client.db("sample_mflix"); const movies = database.collection("movies"); // Create a document to insert const doc = { title: "Charade", genres: ["Comedy", "Romance", "Thriller"], year: 1963, cast: ["Cary Grant", "Audrey Hepburn", "Walter Matthau"], } // Insert the defined document into the "movies" collection const result = await movies.insertOne(doc);
// Print the ID of the inserted document console.log(`A document was inserted with the _id: ${result.insertedId}`); } finally { // Close the MongoDB client connection await client.close(); }}// Run the function and handle any errorsrun().catch(console.dir);import { MongoClient } from "mongodb";
// Replace the uri string with your MongoDB deployment's connection string.const uri = "<connection string uri>";
const client = new MongoClient(uri);
interface Movie { title: string; content: string[]; year: number; cast: string[];}
async function run() { try { const database = client.db("sample_mflix"); // Specifying a Schema is optional, but it enables type hints on // finds and inserts const movies = database.collection<Movie>("movies"); const result = await movies.insertOne({ title: "Charade", genres: ["Comedy", "Romance", "Thriller"], year: 1963, cast: ["Cary Grant", "Audrey Hepburn", "Walter Matthau"], }); console.log(`A document was inserted with the _id: ${result.insertedId}`); } finally { await client.close(); }}run().catch(console.dir);Ao executar o exemplo anterior, você verá a seguinte saída:
A document was inserted with the _id: ...Insira vários documentos
Use o método insertMany() quando quiser inserir vários documentos. Este método insere documentos na ordem especificada até ocorrer uma exceção, se houver.
Por exemplo, suponha que você queira inserir os seguintes documentos:
{ "_id": 1, "color": "red" }{ "_id": 2, "color": "purple" }{ "_id": 1, "color": "yellow" }{ "_id": 3, "color": "blue" }Quando você passa os documentos anteriores para o método insertMany(), o driver insere o primeiro e o segundo documentos, mas lança um WriteError para o terceiro documento porque o ID 1 é duplicado. O driver não insere nenhum documento após esse erro.
Observação
Use um bloco try-catch para obter uma confirmação de documentos processados com êxito antes que o erro ocorra:
const myDB = client.db("myDB");const myColl = myDB.collection("colors");
try { const docs = [ { "_id": 1, "color": "red"}, { "_id": 2, "color": "purple"}, { "_id": 1, "color": "yellow"}, { "_id": 3, "color": "blue"} ];
const insertManyresult = await myColl.insertMany(docs); let ids = insertManyresult.insertedIds;
console.log(`${insertManyresult.insertedCount} documents were inserted.`); for (let id of Object.values(ids)) { console.log(`Inserted a document with id ${id}`); }} catch(e) { console.log(`A MongoBulkWriteException occurred, but there are successfully processed documents.`); let ids = e.result.result.insertedIds; for (let id of Object.values(ids)) { console.log(`Processed a document with id ${id._id}`); } console.log(`Number of documents inserted: ${e.result.result.nInserted}`);}A saída consiste em documentos que o MongoDB pode processar e é semelhante à seguinte:
A MongoBulkWriteException occurred, but there are successfully processed documents.Processed a document with id 1Processed a document with id 2Processed a document with id 1Processed a document with id 3Number of documents inserted: 2Dentro da sua collection, verá os seguintes documentos:
{ "_id": 1, "color": "red" }{ "_id": 2, "color": "purple" }Ao fazer a inserção corretamente, o método gera uma instância InsertManyResult representando o número de documentos inseridos e o _id do novo documento.
Exemplo
O exemplo a seguir usa o método insertMany() para inserir três novos documentos na collection myDB.pizzaMenu:
const myDB = client.db("myDB");const myColl = myDB.collection("pizzaMenu");
const docs = [ { name: "Sicilian pizza", shape: "square" }, { name: "New York pizza", shape: "round" }, { name: "Grandma pizza", shape: "square" }];
const insertManyresult = await myColl.insertMany(docs);let ids = insertManyresult.insertedIds;
console.log(`${insertManyresult.insertedCount} documents were inserted.`);
for (let id of Object.values(ids)) { console.log(`Inserted a document with id ${id}`);}Seu resultado parece semelhante ao seguinte:
3 documents were inserted.Inserted a document with id 60ca09f4a40cf1d1afcd93a2Inserted a document with id 60ca09f4a40cf1d1afcd93a3Inserted a document with id 60ca09f4a40cf1d1afcd93a4Para obter mais informações sobre as classes e métodos mencionados nesta seção, consulte os seguintes recursos:
Documentação da API do insertMany()
Documentação da API sobrem InsertManyResult
Documentação da API sobre PkFactory
Entrada manual do servidor em insertMany()
insertMany() Exemplo: arquivo completo
Observação
Exemplo de configuração
Esse exemplo se conecta a uma instância do MongoDB usando um URI de conexão. Para saber mais sobre como se conectar à sua instância do MongoDB, consulte o Guia de conexão. Este exemplo também usa a coleção movies no banco de dados sample_mflix incluído nos conjuntos de dados de amostra do Atlas. Você pode carregá-los em seu banco de dados em um cluster gratuito no MongoDB Atlas seguindo o MongoDB Get Started.
O código a seguir é um arquivo completo e autônomo que executa uma operação de inserção muitos:
import { MongoClient } from "mongodb";
// Replace the uri string with your MongoDB deployment's connection string.const uri = "<connection string uri>";
const client = new MongoClient(uri);
async function run() { try {
// Get the database and collection on which to run the operation const database = client.db("sample_mflix"); const movies = database.collection("movies");
// Create an array of documents to insert const moviesToInsert = [ { title: "Arsenic and Old Lace", genres: ["Comedy", "Romance"], year: 1944, cast: ["Cary Grant", "Priscilla Lane", "Raymond Massey"] }, { title: "Ball of Fire", genres: ["Comedy", "Romance"], year: 1941, cast: ["Gary Cooper", "Barbara Stanwyck", "Oskar Homolka"] }, { title: "I Married a Witch", genres: ["Comedy", "Fantasy", "Romance"], year: 1942, cast: ["Veronica Lake", "Fredric March", "Susan Hayward"] }, ];
// Prevent additional documents from being inserted if one fails const options = { ordered: true };
// Execute insert operation const result = await movies.insertMany(moviesToInsert, options); // Print result console.log(`${result.insertedCount} documents were inserted`); } finally { await client.close(); }}run().catch(console.dir);import { MongoClient } from "mongodb";
// Replace the uri string with your MongoDB deployment's connection string.const uri = "<connection string uri>";
const client = new MongoClient(uri);
interface Movie { title: string; genres: string[]; year: number; cast: string[];}
async function run() { try { const database = client.db("sample_mflix"); // Specifying a schema is optional, but it enables type hints on // finds and inserts const movies = database.collection<Movie>("movies");
const result = await movies.insertMany( { title: "Arsenic and Old Lace", genres: ["Comedy", "Romance"], year: 1944, cast: ["Cary Grant", "Priscilla Lane", "Raymond Massey"] }, { title: "Ball of Fire", genres: ["Comedy", "Romance"], year: 1941, cast: ["Gary Cooper", "Barbara Stanwyck", "Oskar Homolka"] }, { title: "I Married a Witch", genres: ["Comedy", "Fantasy", "Romance"], year: 1942, cast: ["Veronica Lake", "Fredric March", "Susan Hayward"] }, { ordered: true } ); console.log(`${result.insertedCount} documents were inserted`); } finally { await client.close(); }}run().catch(console.dir);Ao executar o exemplo anterior, você verá a seguinte saída:
3 documents were insertedDocumentação da API
Para saber mais sobre qualquer um dos tipos ou métodos discutidos neste guia, consulte a seguinte documentação da API: