Exclua documentos

Visão geral

Neste guia, você pode aprender como remover documentos com o driver MongoDB Kotlin.

Você pode remover documentos passando um filtro de query para os métodos deleteOne(), deleteMany() ou findOneAndDelete():

• deleteOne() método: Exclui um único documento. Se o filtro de consulta corresponder a mais de um documento, o método removerá a primeira ocorrência de uma correspondência na coleção.

• deleteMany() método: Exclui todos os documentos que correspondem ao filtro de query.

• findOneAndDelete() método: Localiza e exclui a primeira ocorrência de uma correspondência na coleção. Retorna o documento correspondente .

Para especificar um agrupamento ou sugerir um índice, use DeleteOptions como segundo parâmetro para os métodos deleteOne() e deleteMany() .

Para especificar um agrupamento, sugerir um índice, especificar a ordem de classificação ou especificar uma projeção no documento retornado, use FindOneAndDeleteOptions como o segundo parâmetro para o método findOneAndDelete() .

{ "_id": 1, "color": "red", "qty": 5 }
{ "_id": 2, "color": "purple", "qty": 8 }
{ "_id": 3, "color": "blue", "qty": 0 }
{ "_id": 4, "color": "white", "qty": 0 }
{ "_id": 5, "color": "yellow", "qty": 6 }
{ "_id": 6, "color": "pink", "qty": 0 }
{ "_id": 7, "color": "green", "qty": 0 }
{ "_id": 8, "color": "black", "qty": 8 }

data class PaintOrder(
    @BsonId val id: Int,
    val qty: Int,
    val color: String
)

Excluir muitos documentos

O site da loja de tintas exibe todos os documento na collection paint_inventory . Para reduzir a confusão do cliente, a loja deseja remover as cores que estão esgotadas.

Para remover as cores esgotadas, faça query da collection paint_inventory onde qty é 0 e passe a query para o método deleteMany() :

val filter = Filters.eq("qty", 0)
collection.deleteMany(filter)

O seguinte mostra o documento restante na collection paint_inventory :

{ "_id": 1, "color": "red", "qty": 5 }
{ "_id": 2, "color": "purple", "qty": 8 }
{ "_id": 5, "color": "yellow", "qty": 6 }
{ "_id": 8, "color": "black", "qty": 8 }

import com.mongodb.MongoException
import com.mongodb.client.model.Filters
import com.mongodb.kotlin.client.coroutine.MongoClient
import kotlinx.coroutines.runBlocking
data class Movie(val imdb: IMDB){
    data class IMDB(val rating: Double)
}
fun main() = runBlocking {
    // Replace the uri string with your MongoDB deployment's connection string
    val uri = "<connection string uri>"
    val mongoClient = MongoClient.create(uri)
    val database = mongoClient.getDatabase("sample_mflix")
    val collection = database.getCollection<Movie>("movies")
    val query = Filters.lt("${Movie::imdb.name}.${Movie.IMDB::rating.name}", 2.9)
    try {
        val result = collection.deleteMany(query)
        println("Deleted document count: " + result.deletedCount)
    } catch (e: MongoException) {
        System.err.println("Unable to delete due to an error: $e")
    }
    mongoClient.close()
}

Deleted document count: 4

Excluir um documento

A loja está doando a quantidade restante de sua tinta amarela. Isso significa que o qty para o amarelo agora é 0 e precisamos remover o amarelo da collection.

Para remover o amarelo, execute uma consulta na coleção paint_inventory onde color seja "yellow" e utilize essa consulta no método deleteOne():

val filter = Filters.eq("color", "yellow")
collection.deleteOne(filter)

O seguinte mostra o documento restante na collection paint_inventory :

{ "_id": 1, "color": "red", "qty": 5 }
{ "_id": 2, "color": "purple", "qty": 8 }
{ "_id": 8, "color": "black", "qty": 8 }

import com.mongodb.MongoException
import com.mongodb.client.model.Filters
import com.mongodb.kotlin.client.coroutine.MongoClient
import kotlinx.coroutines.runBlocking
data class Movie(val title: String)
fun main() = runBlocking {
    // Replace the uri string with your MongoDB deployment's connection string
    val uri = "<connection string uri>"
    val mongoClient = MongoClient.create(uri)
    val database = mongoClient.getDatabase("sample_mflix")
    val collection = database.getCollection<Movie>("movies")
    val query = Filters.eq(Movie::title.name, "The Garbage Pail Kids Movie")
    try {
        val result = collection.deleteOne(query)
        println("Deleted document count: " + result.deletedCount)
    } catch (e: MongoException) {
        System.err.println("Unable to delete due to an error: $e")
    }
    mongoClient.close()
}

Deleted document count: 1

Deleted document count: 0

Localize e exclua um documento

A loja gostaria de distribuir a quantidade restante de tinta púrpura e remover a cor púrpura da collection paint_inventory .

Para escolher uma cor, faça query da collection paint_inventory onde color é "purple" e passe a query para o método findOneAndDelete() . Ao contrário dos outros métodos de exclusão, o findOneAndDelete() retorna o documento excluído:

val filter = Filters.eq("color", "purple")
val result = collection.findOneAndDelete(filter)
println("The following was deleted: $result")

The following was deleted: PaintOrder(id=2, qty=8, color=purple)

O seguinte mostra o documento restante na collection paint_inventory :

 { "_id": 1, "color": "red", "qty": 5 }
 { "_id": 8, "color": "black", "qty": 8 }

Para obter mais informações sobre os métodos e classes mencionadas neste guia, consulte os seguintes recursos:

• Documentação da API deleteOne()

• Documentação da API deleteMany()

• Documentação da API findOneAndDelete()

• Documentação da API DeleteOptions

• Documentação da API FindOneAndDeleteOptions

• db.coleção.deleteOne() MongoDB Entrada manual do servidor

• db.coleção.deleteMany() MongoDB Entrada manual do servidor

• db.coleção.findOneAndDelete() MongoDB Entrada manual do servidor