Insira documentos

Nesta página

Inserir um único documento

Insira vários documentos
Inserir comportamento
Saiba mais

O MongoDB Shell disponibiliza os seguintes métodos para inserir documentos em uma coleção:

Para inserir um único documento, use db.collection.insertOne().
Para inserir vários documentos, use db.collection.insertMany().

Os exemplos nesta página referenciam o conjunto de dados de amostra do Atlas. Você pode criar um cluster do Atlas gratuito e preencher este agrupamento com dados de amostra para acompanhar junto com estes exemplos. Para mais informações, consulte Iniciar com Atlas.

Inserir um único documento

db.collection.insertOne() insere um documento único em uma coleção. Se o documento não especificar um campo _id, o MongoDB adicionará o campo _id com um valor ObjectId ao novo documento. Consulte a página Inserir comportamento.

Exemplo

Para inserir um novo documento na coleção sample_mflix.movies:

use sample_mflix
db.movies.insertOne(
  {
    title: "The Favourite",
    genres: [ "Drama", "History" ],
    runtime: 121,
    rated: "R",
    year: 2018,
    directors: [ "Yorgos Lanthimos" ],
    cast: [ "Olivia Colman", "Emma Stone", "Rachel Weisz" ],
    type: "movie"
  }
)

insertOne() retorna um documento que inclui o valor de campo _id do documento recém-inserido.

Para recuperar o documento inserido, leia a coleção:

db.movies.find( { title: "The Favourite" } )

Para garantir a devolução do documento inserido, você pode consultar por _id.

Insira vários documentos

db.collection.insertMany() pode inserir vários documentos em uma coleção. Passe um array de documentos para o método. Se os documentos não especificarem um campo _id, o MongoDB adicionará o campo _id com um valor ObjectId a cada documento. Consulte a página Inserir comportamento.

Exemplo

Para inserir dois novos documentos na coleção sample_mflix.movies:

use sample_mflix
db.movies.insertMany([
   {
      title: "Jurassic World: Fallen Kingdom",
      genres: [ "Action", "Sci-Fi" ],
      runtime: 130,
      rated: "PG-13",
      year: 2018,
      directors: [ "J. A. Bayona" ],
      cast: [ "Chris Pratt", "Bryce Dallas Howard", "Rafe Spall" ],
      type: "movie"
    },
    {
      title: "Tag",
      genres: [ "Comedy", "Action" ],
      runtime: 105,
      rated: "R",
      year: 2018,
      directors: [ "Jeff Tomsic" ],
      cast: [ "Annabelle Wallis", "Jeremy Renner", "Jon Hamm" ],
      type: "movie"
    }
])

insertMany() retorna um documento que inclui os valores do campo _id dos documentos recém-inseridos.

Para ler documentos do coleção:

db.movies.find( {} )

Inserir comportamento

Para saber mais sobre o comportamento específico da inserção de documentos, consulte Inserir comportamento.

Saiba mais

Para visualizar mais exemplos de inserção de documentos em uma coleção, consulte as páginas de método insertOne() e db.collection.insertMany().
Para ver todos os métodos disponíveis para inserir documentos em uma coleção, consulte Métodos adicionais para inserções

Voltar

Realizar operações CRUD

Leia