Exclua documentos
Nesta página
O shell do MongoDB oferece os seguintes métodos para excluir documentos de uma collection:
Para excluir vários documentos, use
db.collection.deleteMany().Para excluir um único documento, use
db.collection.deleteOne().
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.
Excluir todos os documentos
Para excluir todos os documentos de uma coleção, passe um documento de filtro vazio {} para o método db.collection.deleteMany().
Exemplo
Para excluir todos os documentos da coleção sample_mflix.movies:
use sample_mflix db.movies.deleteMany({})
O método retorna um documento com o status da operação. Para mais informações e exemplos, consulte deleteMany().
Observação
Se quiser excluir todos os documentos de uma coleção grande, use o método db.collection.drop(). e recriar a coleção pode ter um desempenho mais rápido do que excluir documentos com o método db.collection.deleteMany(). Ao recriar a coleção, você também deve recriar todos os parâmetros de coleção especificados, como índices de coleção.
Excluir todos os documentos que correspondem a uma condição
Você pode especificar critérios ou filtros que identificam os documentos a serem excluídos. Os filtros utilizam a mesma sintaxe que as operações de leitura.
Para especificar condições de igualdade, utilize expressões <field>:<value> no documento do filtro de query.
Para excluir todos os documentos que correspondem a um critério de exclusão, passe um parâmetro de filtro para o método deleteMany().
Exemplo
Para excluir todos os documentos da coleção sample_mflix.movies onde o title é igual a "Titanic":
use sample_mflix db.movies.deleteMany( { title: "Titanic" } )
O método retorna um documento com o status da operação. Para mais informações e exemplos, consulte deleteMany().
Excluir apenas um documento que corresponda a uma condição
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().
Exemplo
Para excluir o primeiro documento da sample_mflix.movies collection onde o array cast contém "Brad Pitt":
use sample_mflix db.movies.deleteOne( { cast: "Brad Pitt" } )
Observação
O MongoDB preserva uma ordem de classificação natural para documentos. Essa ordenação é um recurso de implementação interna, e você não deve confiar em nenhuma estrutura específica dentro dela. Para saber mais, consulte ordem natural.
Excluir comportamento
Para saber mais sobre o comportamento específico da exclusão de documentos, consulte Comportamento.
Saiba mais
Para ver outros exemplos de exclusão de documentos, consulte as seguintes páginas de método:
Para ver todos os métodos disponíveis para excluir documentos, consulte Excluir métodos.