/ /

Valores únicos de campo

Overview

Dentro de una colección, diferentes documentos pueden contener distintos valores para un mismo campo. Por ejemplo, un documento en la restaurant Una colección tiene un valor borough de "Manhattan" y otra tiene un valor borough de "Queens". Con el controlador de sincronización de Kotlin, puede recuperar todos los valores distintos que contiene un campo en varios documentos de una colección.

Datos de muestra

Los ejemplos de esta guía utilizan la colección restaurants en la base de datos sample_restaurants de la Conjuntos de datos de muestra de Atlas. Para aprender a crear una implementación gratuita de MongoDB y cargar los conjuntos de datos de muestra, consulte la guía de introducción a MongoDB.

La siguiente clase de datos de Kotlin modela los documentos de esta colección:

data class Restaurant(
    val name: String,
    val borough: String,
    val cuisine: String
)

`distinct()` Método

Para recuperar los valores distintos de un campo específico, llame al método distinct() y pase el nombre del campo para el cual desea encontrar valores distintos.

Recuperar valores distintos en una colección

El siguiente ejemplo recupera los valores distintos del campo borough en la colección restaurants:

val results = collection.distinct<String>(Restaurant::borough.name)
results.forEach { result ->
    println(result)
}

Bronx
Brooklyn
Manhattan
Missing
Queens
Staten Island

Los resultados muestran todos los valores distintos que aparecen en el campo borough en todos los documentos de la colección. Aunque varios documentos tienen el mismo valor en el campo borough, cada valor aparece solo una vez en los resultados.

Recupere valores distintos en documentos especificados

Puede aplicar un filtro de consulta al distinct() método para encontrar los distintos valores de campo en un subconjunto de documentos de una colección. Un filtro de consulta es una expresión que especifica los criterios de búsqueda utilizados para encontrar coincidencias en los documentos de una operación. Para obtener más información sobre cómo crear un filtro de consulta, consulte Especifique una consulta.

El siguiente ejemplo recupera los valores distintos del campo borough para todos los documentos que tienen un valor de campo cuisine de "Italian":

val results = collection.distinct<String>(
    Restaurant::borough.name,
    eq(Restaurant::cuisine.name, "Italian")
)
results.forEach { result ->
    println(result)
}

Bronx
Brooklyn
Manhattan
Queens
Staten Island

Modificar el comportamiento de Distinct

El método distinct() se puede modificar encadenando métodos a la llamada al método distinct(). Si no se especifica ninguna opción, el controlador no personaliza la operación.

La siguiente tabla describe algunos métodos que puede utilizar para personalizar la operación distinct():

Método	Descripción
`batchSize()`	Sets the number of documents to return per batch.
`collation()`	Specifies the kind of language collation to use when sorting results. For more information, see Collation in the MongoDB Server manual.
`comment()`	Specifies a comment to attach to the operation.
`filter()`	Sets the query filter to apply to the query.
`forEach()`	Performs the given action on each element returned by the `distinct()` operation.

Para obtener una lista completa de los métodos que puede utilizar para modificar el distinct() método, consulte la documentación de la API DistinctIterable.

El siguiente ejemplo recupera los valores distintos del campo name para todos los documentos cuyo valor de campo borough es "Bronx" y cuyo valor de campo cuisine es "Pizza". También utiliza la opción comment para añadir un comentario a la operación.

val results = collection.distinct<String>(
    Restaurant::name.name,
    and(
        eq(Restaurant::borough.name, "Bronx"),
        eq(Restaurant::cuisine.name, "Pizza")
    )
).comment("Bronx pizza restaurants")
results.forEach { result ->
    println(result)
}

$1.25 Pizza
18 East Gunhill Pizza
2 Bros
Aenos Pizza
Alitalia Pizza Restaurant
...

Información Adicional

Para obtener más información sobre el comando distinct, consulte la guía Distinct en el Manual del servidor MongoDB.

Documentación de la API

Para aprender más sobre cualquiera de los métodos o tipos analizados en esta guía, consulta la siguiente documentación de API:

Volver

Contabilizar documentos

Acceder a datos desde un cursor