distinct (comando de base de datos)

Campos de arreglo

Si el valor del field especificado es una matriz, distinct considera cada elemento de la matriz como un valor separado.

Por ejemplo, si un campo tiene como valor [ 1, [1], 1 ], entonces distinct considera 1, [1] y 1 como valores separados.

A partir de MongoDB 6.0, el comando distinct devuelve los mismos resultados para colecciones y vistas cuando se utilizan matrices.

Para ver ejemplos, consulta:

• Devolver valores únicos para un campo de arreglo

• Arreglos en colecciones y vistas

Uso del índice

Cuando sea posible, las operacionesdistinct pueden usar índices.

Los índices también pueden abarcar operaciones distinct. Consulte Ejecutar consultas cubiertas para obtener más información sobre las consultas cubiertas por índices.

Transacciones

Para realizar una operación específica dentro de una transacción:

• Para colecciones no fragmentadas, puede utilizar el método db.collection.distinct()/el comando distinct, así como la canalización de agregación con la etapa $group.

• Para colecciones fragmentadas, no se puede utilizar el método db.collection.distinct() ni el comando distinct.

  Para encontrar los valores distintos de una colección fragmentada, utiliza la canalización de agregación con la etapa $group en su lugar. Consulta la Operación distinta para obtener más detalles.

Desconexión del cliente

Si el cliente que emitió distinct se desconecta antes de que la operación finalice, MongoDB marca distinct para su terminación usando killOp.

Restricción del estado del set de réplicas

Para ejecutarse en un miembro del conjunto de réplicas, las operacionesdistinct requieren que el miembro esté en estado PRIMARY oSECONDARY. Si el miembro está en otro estado, como STARTUP2, la operación genera un error.

Intercalaciones y filtros de índices

A partir de MongoDB 6.0, un filtro de índice utiliza la intercalación establecida previamente mediante el comando planCacheSetFilter.

A partir de MongoDB 8.0, utiliza la configuración del query en lugar de añadir filtros de índice. Los filtros de índices están en desuso a partir de MongoDB 8.0.

La configuración de queries tiene más funcionalidades que los filtros de índices. Además, los filtros de índice no son persistentes y no puedes crear fácilmente filtros de índice para todos los nodos del clúster. Para añadir ajustes de query y explorar ejemplos, consulta setQuerySettings.

Configuración de query

Puedes utilizar la configuración de query para establecer sugerencias de índice, fijar filtros de rechazo de operación y otros campos. Los ajustes se aplican a la forma de la query en todo el clúster. El clúster retiene la configuración después del apagado.

El optimizador de query utiliza la configuración del query como entrada adicional durante la planificación del query, lo que afecta al plan seleccionado para ejecutar el query. También puedes usar la configuración del query para bloquear una forma del query.

Para añadir configuraciones de query y explorar ejemplos, consulte setQuerySettings.

Puedes agregar configuraciones de consulta para los comandos find, distinct y aggregate.

La configuración de query tiene más funcionalidades y se prefiere sobre los filtros de índice en desuso.

Para remover la configuración del query, utilice removeQuerySettings. Para obtener la configuración del query, utilice una etapa de $querySettings en una canalización de agregación.

Devolver valores distintos para un campo

El siguiente ejemplo devuelve valores dept distintos de la colección inventory:

db.runCommand ( { distinct: "inventory", key: "dept" } )

El comando devuelve un documento con un campo values que contiene los valores dept distintos:

{
   "values" : [ "A", "B" ],
   "ok" : 1
}

Devolver valores únicos para un campo incrustado

El siguiente ejemplo devuelve valores distintos para el campo incrustado item.sku de la colección inventory:

db.runCommand ( { distinct: "inventory", key: "item.sku" } )

El comando devuelve un documento con un campo values que contiene los valores sku distintos:

{
  "values" : [ "111", "222", "333" ],
  "ok" : 1
}

Devolver valores únicos para un campo de arreglo

El siguiente ejemplo devuelve valores sizes distintos de la colección inventory:

db.runCommand ( { distinct: "inventory", key: "sizes" } )

El comando devuelve un documento con un campo values que contiene los valores sizes distintos:

{
  "values" : [ "M", "S", "L" ],
  "ok" : 1
}

Para obtener información sobre distinct y los campos de matriz, consulte la sección Comportamiento.

Arreglos en colecciones y vistas

A partir de MongoDB 6.0, el comando distinct devuelve los mismos resultados para colecciones y vistas cuando se utilizan matrices.

El siguiente ejemplo crea una colección llamada sensor con un arreglo de valores de temperatura para cada documento:

db.sensor.insertMany( [
   { _id: 0, temperatures: [ { value: 1 }, { value: 4 } ] },
   { _id: 1, temperatures: [ { value: 2 }, { value: 8 } ] },
   { _id: 2, temperatures: [ { value: 3 }, { value: 12 } ] },
   { _id: 3, temperatures: [ { value: 1 }, { value: 4 } ] }
] )

El siguiente ejemplo crea una vista llamada sensorView a partir de la colección sensor:

db.createView( "sensorView", "sensor", [] )

El siguiente ejemplo utiliza distinct para devolver los valores únicos del array temperatures en la colección sensor:

db.sensor.distinct( "temperatures.1.value" )

El 1 en temperatures.1.value especifica el índice de arreglo temperatures.

Ejemplo de salida:

[ 4, 8, 12 ]

Ejemplo para sensorView:

db.sensorView.distinct( "temperatures.1.value" )

Ejemplo de salida:

• [ 4, 8, 12 ] a partir de MongoDB 6.0 (idéntico al resultado devuelto desde la colección sensor).

• [] en versiones de MongoDB anteriores a la 6.0.

Especifica la query con distinct

El siguiente ejemplo devuelve valores distintos para el campo item.sku incrustado donde dept es igual a "A":

db.runCommand ( { distinct: "inventory", key: "item.sku", query: { dept: "A"} } )

El comando devuelve un documento con un campo values que contiene los valores sku distintos:

{
  "values" : [ "111", "333" ],
  "ok" : 1
}

Especifica una intercalación

La intercalación permite a los usuarios especificar reglas propias del lenguaje para la comparación de strings, como reglas para el uso de mayúsculas y minúsculas y marcas de acento.

Una colección myColl tiene los siguientes documentos:

{ _id: 1, category: "café", status: "A" }
{ _id: 2, category: "cafe", status: "a" }
{ _id: 3, category: "cafE", status: "a" }

La siguiente operación de agregación incluye la opción de intercalación de MongoDB:

db.runCommand(
   {
      distinct: "myColl",
      key: "category",
      collation: { locale: "fr", strength: 1 }
   }
)

Para obtener descripciones sobre los campos de intercalación, consulta el Documento de intercalación.

Anular el nivel de consistencia de lectura por defecto

Para anular el nivel de consistencia de lectura por defecto de "local", usa la opción readConcern.

La siguiente operación en un Set de réplicas especifica un nivel de consistencia de lectura de "majority" para leer la copia más reciente de los datos confirmados como están escritos en la mayoría de los nodos.

db.runCommand(
   {
     distinct: "restaurants",
     key: "rating",
     query: { cuisine: "italian" },
     readConcern: { level: "majority" }
   }
)

Para asegurarte de que un solo hilo pueda leer sus propias escrituras, utiliza el nivel de consistencia de lectura "majority" y el nivel de confirmación de escritura "majority" contra el primario del set de réplicas.

Especifica un índice

Puedes especificar un nombre de índice o un patrón utilizando la opción de sugerencia.

Para especificar una sugerencia basada en el nombre de un índice:

db.runCommand ( { distinct: "inventory", key: "dept", hint: "sizes" } )

Para especificar una sugerencia basada en un patrón de índice:

db.runCommand ( { distinct: "inventory", key: "dept", hint: { sizes: 1 } } )