Menu Docs
Página inicial do Docs
/ / /
PyMongo
/

Exclua documentos

Nesta página

  • Visão geral
  • Dados de amostra
  • Excluir operações
  • Excluir um documento
  • Excluir vários documentos
  • Personalizar a operação de exclusão
  • Valor de retorno
  • Documentação da API

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() .

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 .

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 Search

  • delete_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 .

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)

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)

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".

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ídos

  • acknowledged, que indica se o servidor reconhece o resultado

  • raw_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.

Para saber mais sobre qualquer um dos métodos ou tipos discutidos neste guia, consulte a seguinte documentação da API:

Voltar

Substituir documentos