Exclua documentos
Nesta página
Visão geral
Neste guia, você pode aprender como usar o PyMongo para remover documentos de uma coleção MongoDB realizando operações de exclusão.
Uma operação de exclusão remove um ou mais documentos de uma collection do MongoDB. Você pode executar uma operação de exclusão utilizando os métodos delete_one()
ou delete_many()
.
Dados de amostra
Os exemplos neste guia usam a collection sample_restaurants.restaurants
dos conjuntos de dados de amostra do Atlas. Para saber como criar um cluster MongoDB Atlas gratuito e carregar os conjuntos de dados de amostra, consulte o tutorial Introdução ao PyMongo .
Excluir operações
Você pode executar operações de exclusão no MongoDB usando os seguintes métodos:
delete_one()
, que exclui o primeiro documento que corresponde aos critérios do Atlas Searchdelete_many()
, que exclui todos os documentos que correspondem aos critérios do Atlas Search
Cada método de exclusão requer um documento de filtro de query , que especifica os critérios do Atlas Search que determinam quais documentos selecionar para remoção. Para obter mais informações sobre filtros de query, consulte a seção Documentos de filtro de query no manual do MongoDB Server .
Excluir um documento
O exemplo a seguir usa o método delete_one()
para remover um documento na collection restaurants
com um valor name
de "Ready Penny Inn"
:
query_filter = { "name": "Ready Penny Inn" } result = restaurants.delete_one(query_filter)
Excluir vários documentos
O exemplo seguinte utiliza o método delete_many()
para remover todos os documentos na coleção restaurants
com um valor borough
de "Brooklyn"
:
query_filter = { "borough": "Brooklyn" } result = restaurants.delete_many(query_filter)
Personalizar a operação de exclusão
Os métodos delete_one()
e delete_many()
aceitam opcionalmente parâmetros adicionais, que representam opções que você pode usar para configurar a operação de exclusão. Se você não especificar nenhuma opção adicional, o driver não personalizará a operação de exclusão.
Propriedade | Descrição |
---|---|
collation | Specifies the kind of language collation to use when sorting
results. For more information, see Collation
in the MongoDB Server manual. |
hint | Gets or sets the index to scan for documents.
For more information, see the hint statement
in the MongoDB Server manual. |
session | An instance of ClientSession . |
let | A map of parameter names and values. Values must be constant or closed
expressions that don't reference document fields. For more information,
see the let statement in the
MongoDB Server manual. |
comment | A comment to attach to the operation. For more information, see the delete command
fields guide in the
MongoDB Server manual for more information. |
O código abaixo usa o método delete_many()
para excluir todos os documentos na collection restaurants
com um valor name
que inclui a string "Mongo"
. Ele também usa a opção comment
para adicionar um comentário à operação:
query_filter = { 'name': {'$regex': 'Mongo' }} result = restaurants.delete_many(query_filter, comment="Deleting Mongo restaurants")
Dica
Se o exemplo anterior usasse o método delete_one()
em vez de delete_many()
, o driver excluiria apenas o primeiro documento com um valor name
que incluísse "Mongo"
.
Valor de retorno
Os métodos delete_one()
e delete_many()
retornam um tipo DeleteResult
. Este tipo contém as seguintes propriedades:
deleted_count
, que indica o número de documentos excluídosacknowledged
, que indica se o servidor reconhece o resultadoraw_result
, que é o resultado bruto retornado pelo servidor
Observação
Se o atributo acknowledged
for False
, todos os outros atributos de DeleteResult
gerarão uma exceção InvalidOperation
quando acessados. O driver não pode determinar esses valores se o servidor não reconhecer a operação de gravação.
Se o filtro de query não corresponder a nenhum documento, o driver não excluirá nenhum documento e deleted_count
será 0.
Documentação da API
Para saber mais sobre qualquer um dos métodos ou tipos discutidos neste guia, consulte a seguinte documentação da API: