Visão geral
Neste guia, você pode aprender como usar o driver Ruby 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 restaurants no banco de dados sample_restaurants dos conjuntos de dados de amostra do Atlas. Para acessar essa coleção a partir do seu aplicação Ruby, crie um objeto Mongo::Client que se conecte a um Atlas cluster e atribua os seguintes valores às suas variáveis database e collection:
database = client.use('sample_restaurants') collection = database[:restaurants]
Para aprender a criar um cluster MongoDB Atlas gratuito e carregar os conjuntos de dados de amostra, consulte o Guia de Introdução do MongoDB.
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 parâmetro de filtro de query, que especifica os critérios de pesquisa que determinam quais documentos selecionar para remoção. Para saber mais sobre filtros de query, consulte o guia Especificar uma query.
Excluir um documento
O exemplo a seguir usa o método delete_one para remover um documento no qual o valor do campo name é "Happy Garden":
filter = { name: 'Happy Garden' } result = collection.delete_one(filter) puts "Deleted #{result.deleted_count} document(s)"
Deleted 1 document(s)
Excluir vários documentos
O exemplo a seguir usa o método delete_many para remover todos os documentos nos quais o valor do campo borough é "Brooklyn" e o valor do campo name é "Starbucks":
filter = { name: 'Starbucks', borough: 'Brooklyn' } result = collection.delete_many(filter) puts "Deleted #{result.deleted_count} document(s)"
Deleted 3 document(s)
Personalizar a operação de exclusão
Você pode passar um objeto Hash como parâmetro para os métodos delete_one e delete_many para definir opções para configurar a operação de exclusão. Se você não especificar nenhuma opção, o driver executará a operação de exclusão com as configurações padrão.
A tabela a seguir descreve as opções que você pode usar para configurar a operação de exclusão:
Opção | Descrição |
|---|---|
| Especifica o tipo de agrupamento de idiomas a ser usado ao classificar os resultados. Para obter mais informações, consulte Agrupamento no manual do MongoDB Server . |
| Especifica a sessão a ser usada para a operação. Para saber mais sobre sessões, consulte Sessões de cliente e garantias de consistência causal no manual do MongoDB Server . |
| |
| Fornece um mapa de nomes e valores de parâmetros para definir variáveis de nível superior para a operação. Os valores devem ser expressões constantes ou fechadas que não façam referência aos campos do documento . Para obter mais informações, consulte a opção let na |
Exemplo de modificação de exclusão
O código a seguir especifica a opção hint para instruir a operação de exclusão a usar o índice "name_index". Em seguida, o exemplo utiliza o método delete_many para excluir todos os documentos na coleção restaurants com um valor de campo name que inclui a string "Red".
filter = { name: /Red/ } options = { hint: 'name_index' } result = collection.delete_many(filter, options) puts "Deleted #{result.deleted_count} document(s)"
Deleted 124 document(s)
Dica
Se você usar o método delete_one no exemplo anterior, em vez do método delete_many , o driver excluirá apenas o primeiro documento que corresponde ao filtro de query.
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: