Menu Docs
Página inicial do Docs
/
Idiomas
/
JavaScript
/
Node.js
/
Exemplos de uso
/
Inserir operações

Insira um documento

Você pode inserir um documento em uma coleção usando o arquivo 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 método insertOne() criará a coleção.

Você pode especificar opções de consulta adicionais utilizando 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.

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
8async function run() {
9  try {
10    const database = client.db("insertDB");
11    const haiku = database.collection("haiku");
12    // create a document to insert
13    const doc = {
14      title: "Record of a Shriveled Datum",
15      content: "No bytes, no problem. Just insert a document, in MongoDB",
16    }
17    const result = await haiku.insertOne(doc);
18
19    console.log(`A document was inserted with the _id: ${result.insertedId}`);
20  } finally {
21    await client.close();
22  }
23}
24run().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);

Se você executar o exemplo anterior, verá a seguinte saída:

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

Voltar

Inserir operações