Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/
Operações do MongoDB CRUD

Atualize documentos

Nesta página

  • Atualizar documentos em uma coleção
  • Atualizar um documento com MongoDB Atlas
  • Comportamento

Você pode atualizar documentos no MongoDB com os seguintes métodos:

  • O driver da sua linguagem de programação.

  • A UI do MongoDB Atlas. Para saber mais, consulte Atualizar um documento com o MongoDB Atlas.

  • MongoDB Compass.

➤ Use o menu suspenso Selecione a linguagem no canto superior direito para definir a linguagem dos exemplos a seguir.

Atualizar documentos em uma coleção

Observação

O MongoDB pode aceitar um aggregation pipeline para especificar as modificações a serem feitas em vez de um documento de atualização. Para obter detalhes, consulte a página de referência do método.

Atualizar um único documento

Atualizar vários documentos

Substituir um documento

Atualizar um documento com MongoDB Atlas

Observação

Você pode atualizar somente um documento de cada vez na UI do MongoDB Atlas. Para atualizar vários documentos ou substituir um documento inteiro, conecte-se ao seu sistema Atlas a partir do mongosh ou de um driver do MongoDB e siga os exemplos nesta página para obter seu método preferido.

O exemplo desta seção usa o conjunto de dados de suprimentos de amostra. Para saber como carregar o conjunto de dados de amostra em sua implantação do MongoDB Atlas, consulte Carregar Dados de Amostra.

Para atualizar um documento no MongoDB Atlas, siga estas etapas:

1

Navegue até a coleção.

  1. Na interface do usuário do Atlas MongoDB, clique em Database na barra lateral.

  2. Para a implantação do banco de dados que contém os dados de amostra, clique em Browse Collections.

  3. No painel de navegação esquerdo, selecione o banco de dados sample_supplies.

  4. Selecione a collection sales.

2

Especifique um documento de filtro de consulta.

Você pode especificar um documento de filtro de query no campo Filter. Um documento de filtro de query usa operadores de query para especificar as condições de pesquisa.

Copie o seguinte documento de filtro de query na barra de pesquisa do Filter e clique em Apply:

{ saleDate: { $gte: { $date: "2016-01-01T00:00-00:00" }, $lte: { $date: "2016-01-02T00:00-00:00" } } }

Esse filtro de query retorna todos os documentos na coleção sample_supplies.sales em que saleDate é em ou entre 1 e 2 de janeiro de 2016, horário UTC.

3

Editar um documento.

Para editar um documento exibido nos resultados da query, passe o mouse sobre o documento e clique no ícone de lápis. No editor de documentos, você pode:

  • Adicionar um novo campo.

  • Excluir um campo existente.

  • Editar o nome, valor ou tipo de um campo.

  • Reverter uma alteração específica.

Para obter instruções detalhadas, consulte Criar, exibir, atualizar e excluir documentos.

4

Salvar suas alterações.

Para confirmar e guardar as suas alterações, clique no botão Update.

Comportamento

Atomicidade

Todas as operações de gravação no MongoDB são atômicas no nível de um único documento. Para obter mais informações sobre MongoDB e atomicidade, consulte Atomicidade e transações.

_id Campo

Uma vez definido, não é possível atualizar o valor do campo _id nem substituir um documento existente por um documento de substituição que tenha um valor de campo _id diferente.

Ordem do campo

Para operações de gravação, o MongoDB preserva a ordem dos campos do documento,exceto para os seguintes casos:

  • O campo _id é sempre o primeiro campo do documento.

  • As atualizações que incluem renaming dos nomes de campos podem resultar na reordenação de campos no documento.

Opção Upsert

Escrever confirmação

Com preocupações de gravação, você pode especificar o nível de confirmação solicitado do MongoDB para operações de gravação. Para mais informações, consulte preocupação de gravação.

← Iterar um cursor em mongosh
Atualizações com pipeline de agregação →

Nesta página