Menu Docs
Página inicial do Docs
/
MongoDB Compass
/ /

Modificar documento único

Nesta página

  • Limitações
  • Procedimento
  • Cancelar alterações
  • Modificar vários documentos

Você pode editar documentos existentes em sua collection.

Quando você edita um documento no modo de exibição Lista ou Tabela, o Compass executa uma operação findOneAndUpdate e atualiza apenas os campos que você alterou.

Quando você edita um documento na visualização JSON, o Compass executa uma operação findOneAndReplace e substitui o documento.

  • Não é permitido modificar documentos em MongoDB Compass Readonly Edition.

Selecione a aba apropriada dependendo se você está visualizando seus documentos em lista, JSON ou Tabela:

Seleção de exibição do documento
clique para ampliar

Para modificar um documento, passe o mouse sobre ele e clique no ícone de lápis:

Seleção de edição de documento
clique para ampliar

Depois de clicar no ícone de lápis, o documento entra no modo de edição. Agora você pode fazer alterações nos campos, valores ou tipos de dados de valores.

Para excluir um campo de um documento, clique no ícone à esquerda do campo:

Exclusão de documento
clique para ampliar

Uma vez selecionado, o campo é marcado para remoção e aparece destacado em vermelho. O Compass pede confirmação de que você deseja atualizar o documento removendo o campo.

Para adicionar um novo campo no documento após um campo existente, passe o mouse sobre o número da linha na caixa de diálogo e clique no sinal de mais. O número da linha não faz parte do documento, mas faz parte da exibição da caixa de diálogo.

Adicione um campo a um documento
clique para ampliar

Você também pode adicionar um novo campo no final do documento pressionando a tecla Tab quando o cursor de texto estiver no valor do último campo de documento.

Para modificar documentos, clique nos nomes ou valores dos campos existentes e faça as alterações. Neste exemplo, o borough foi alterado de Manhattan para Queens. Os campos alterados aparecem destacados em amarelo:

Exibição de atualização de documento
clique para ampliar

Quando você edita um documento no modo de exibição Lista ou Tabela, o Compass executa uma operação findOneAndUpdate e atualiza somente os campos que você alterou.

Se o Compass detectar que você alterou campos que foram modificados fora do Compass, ele o notificará, impedindo que você sobrescreva acidentalmente as alterações feitas fora do Compass. Você pode optar por continuar e substituir o documento clicando em Update ou cancelar suas alterações.

Quando terminar de editar o documento, clique no botão Update para confirmar suas alterações.

Para reverter as alterações para um documento, passe o mouse sobre o campo editado e clique no revert icon que aparece à esquerda do número da linha do campo.

Inverter documento na visualização de lista

Observação

A Visualização JSON está disponível a partir do Compass 1.20.

Para modificar um documento, passe o mouse sobre ele e clique no ícone de lápis:

Seleção de edição de documento na visualização JSON
clique para ampliar

Depois de clicar no ícone de lápis, o documento entra no modo de edição. Agora você pode adicionar, remover e editar valores de campo modificando o JSON document.

Por padrão, esta visualização oculta objetos e arrays incorporados. Para expandir objetos incorporados e elementos de array, passe o mouse sobre o documento de destino e clique na seta superior no lado esquerdo do documento.

Para expandir objetos e matrizes individuais, clique na seta à esquerda do campo desejado.

Expandir objetos incorporados na visualização JSON
clique para ampliar

Quando você edita um documento na visualização JSON, o Compass executa uma operação findOneAndReplace e substitui o documento.

Se o Compass detectar que você alterou campos que foram modificados fora do Compass, ele o notificará, impedindo que você sobrescreva acidentalmente as alterações feitas fora do Compass. Você pode optar por continuar e substituir o documento clicando em Update ou cancelar suas alterações.

Para modificar um documento, passe o mouse sobre ele e clique no ícone de lápis:

Seleção de edição de documento na exibição Table
clique para ampliar

Depois de clicar no ícone de lápis, o documento entra no modo de edição.

Quando você edita um documento no modo de exibição Lista ou Tabela, o Compass executa uma operação findOneAndUpdate e atualiza somente os campos que você alterou.

Se o Compass detectar que você alterou campos que foram modificados fora do Compass, ele o notificará, impedindo que você sobrescreva acidentalmente as alterações feitas fora do Compass. Você pode optar por continuar e substituir o documento clicando em Update ou cancelar suas alterações.

Para excluir um campo de um documento:

  1. Clique no valor do campo que você deseja excluir.

  2. Clique no ícone .

  3. Clique em Update para confirmar suas alterações.

Para adicionar um novo campo ao documento:

  1. Clique no campo após o qual você deseja adicionar o novo campo.

  2. Clique no ícone .

  3. Clique em Add Field after <Field Name>.

  4. Preencha seu campo recém-criado.

  5. Clique em Update para confirmar suas alterações.

Ao modificar um documento, você tem a opção de reverter as alterações feitas em um campo antes de salvar o documento modificado.

Clique no revert icon que aparece no lado direito do elemento da tabela editado.

Alterações de reversão de documentos na exibição em tabela

Para sair do modo de edição e cancelar todas as alterações pendentes no documento, clique no botão Cancel.

Você pode usar o fluxo de trabalho de operações de atualização em massa para atualizar vários documentos no Compass. Para obter detalhes, consulte Modificar vários documentos.

Observação

Você também pode usar o db.collection.updateMany() no shell do MongoDB incorporado para atualizar vários documentos em uma única operação.

Voltar

Insert