Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

Exclua documentos

No MongoDB, uma operação de excluir consiste em excluir documentos de uma coleção. Esta página fornece exemplos.

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


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


Esta página usa os seguintes métodos mongosh:

Os exemplos nesta página utilizam a collection inventory. Para preencher a collection inventory, execute o seguinte:

db.inventory.insertMany( [ { item: "journal", qty: 25, size: { h: 14, w: 21, uom: "cm" }, status: "A" }, { item: "notebook", qty: 50, size: { h: 8.5, w: 11, uom: "in" }, status: "P" }, { item: "paper", qty: 100, size: { h: 8.5, w: 11, uom: "in" }, status: "D" }, { item: "planner", qty: 75, size: { h: 22.85, w: 30, uom: "cm" }, status: "D" }, { item: "postcard", qty: 45, size: { h: 10, w: 15.25, uom: "cm" }, status: "A" },] );

Para excluir todos os documentos de uma collection, passe um documento filtro vazio {} para o método db.collection.deleteMany().

O exemplo a seguir exclui todos os documentos da collection inventory:

db.inventory.deleteMany({})

O método retorna um documento com o status da operação. Para obter mais informações e exemplos, consulte deleteMany().

Você pode especificar critérios ou filtros que identifiquem os documentos a serem excluídos. Os filtros utilizam a mesma sintaxe das operações de leitura.

Para especificar condições de igualdade, utilize expressões <field>:<value> no documento do filtro de queries:

{ <field1>: <value1>, ... }

Um documento de filtro de queries pode usar os operadores de consulta para especificar condições no seguinte formato:

{ <field1>: { <operator1>: <value1> }, ... }

Para excluir todos os documentos correspondentes a um critério de exclusão, passe um parâmetro de filtro para o método deleteMany().

O exemplo a seguir remove todos os documentos da collection inventory em que o campo status é igual a "A":

db.inventory.deleteMany({ status : "A" })

O método retorna um documento com o status da operação. Para obter mais informações e exemplos, consulte deleteMany().

Para excluir no máximo um único documento que corresponda a um filtro especificado (mesmo que vários documentos possam corresponder ao filtro especificado), use o método db.collection.deleteOne().

O exemplo a seguir exclui o primeiro documento em que status é "D":

db.inventory.deleteOne( { status: "D" } )

Observação

Você pode excluir somente um documento de cada vez na IU do Atlas MongoDB. Para excluir vários documentos, conecte-se à sua implantação do Atlas a partir de mongosh ou de um driver do MongoDB e siga os exemplos nesta página para o método de sua preferência.

O exemplo nesta seção utiliza o conjunto de dados de filmes de amostra. Para saber como carregar o conjunto de dados de amostra em sua implantação do MongoDB Atlas, consulte Carregue dados de amostra.

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

1
  1. Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.

  2. Se ainda não estiver exibido, selecione seu projeto no menu Projects na barra de navegação.

  3. Na barra lateral, clique em Clusters sob o título Database.

    A página Clusters é exibida.

2
  1. Para o cluster que contém os dados de amostra, clique em Browse Collections.

  2. No painel de navegação esquerdo, selecione o banco de dados sample_mflix.

  3. Selecione a collection movies.

3

Opcionalmente, 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:

{ genres: "Action", rated: { $in: [ "PG", "PG-13" ] } }

Este filtro de queries retorna todos os documentos da coleção sample_mflix.movies onde genres é igual a Action e rated é igual a PG ou PG-13.

4
  1. Para o documento que você deseja excluir, passe o mouse sobre o documento e clique no ícone de lixeira que aparece no lado direito.

    Após clicar no botão excluir, o MongoDB Atlas sinaliza o documento para exclusão e solicita sua confirmação.

  2. Clique em Delete para confirmar sua seleção.

Para saber mais, consulte Criar, exibir, atualizar e excluir documentos.

As operações de exclusão não eliminam índices, mesmo excluindo todos os documentos de uma coleção.

Observação

Atomicidade e confirmação de gravar

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

Você também pode usar write concerns para especificar o nível de confirmação solicitado do MongoDB para operações de gravação. Para obter mais informações, consulte write concern.