Menu Docs
Página inicial do Docs
/ / /
Controlador Node.js
/ /

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.

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.

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.

1import { MongoClient } from "mongodb";
2
3// Replace the uri string with your MongoDB deployment's connection string.
4const uri = "<connection string uri>";
5
6// Create a new client and connect to MongoDB
7const client = new MongoClient(uri);
8
9async 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
31run().catch(console.dir);
1import { MongoClient } from "mongodb";
2
3// Replace the uri string with your MongoDB deployment's connection string.
4const uri = "<connection string uri>";
5
6const client = new MongoClient(uri);
7
8interface Haiku {
9 title: string;
10 content: string;
11}
12
13async 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}
28run().catch(console.dir);

Ao executar o exemplo anterior, você vê a seguinte saída:

A document was inserted with the _id: <your _id value>

Voltar

Inserir operações