distinto (comando de base de datos)

Campos de arreglo

Si el valor del field especificado es un arreglo, distinct considera cada elemento del arreglo 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 devuelve los distinct mismos resultados para colecciones y vistas cuando se utilizan matrices.

Para ver ejemplos, consulta:

• Devolver valores únicos para un campo de arreglo

• Matrices en colecciones y vistas

Uso del índice

Cuando sea posible, las operaciones de distinct pueden utilizar índices.

Los índices también pueden cubrir operaciones distinct. Consulte Ejecutar queries cubiertos para obtener más información sobre los queries cubiertos por índices.

Transacciones

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

• Para colecciones sin partición, puedes utilizar el método db.collection.distinct() /el comando distinct así como el pipeline de agregación, con la etapa $group.

• Para las colecciones particionadas, no puedes usar el método db.collection.distinct() o 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 se complete, MongoDB marca distinct para su terminación usando killOp.

Restricción del estado del set de réplicas

Para que se ejecuten en un nodo del set de réplicas, las operaciones distinct requieren que el nodo esté en estado PRIMARY o SECONDARY. Si el nodo se encuentra en otro estado, como STARTUP2, la operación falla.

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.

Devolver valores distintos para un campo

El siguiente ejemplo devuelve los valores distintos para el campo dept de todos los documentos en la colección inventory:

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

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

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

Devolver valores únicos para un campo incrustado

El siguiente ejemplo devuelve los valores distintos del campo sku, incrustado en el campo item, de todos los documentos de la colección inventory:

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

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

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

Devolver valores únicos para un campo de arreglo

El siguiente ejemplo devuelve los valores distintos para el campo sizes de todos los documentos en la colección inventory:

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

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

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

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

Matrices en colecciones y vistas

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

El siguiente ejemplo crea una colección llamada sensor con una matriz 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 de la colección sensor:

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

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

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

El 1 en temperatures.1.value especifica el índice de la matriz temperatures.

Ejemplo de salida:

[ 4, 8, 12 ]

Ejemplo para sensorView:

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

Ejemplo de salida:

• [ 4, 8, 12 ] comenzando en MongoDB 6.0 (idéntico al resultado devuelto por la colección sensor).

• [] en versiones de MongoDB anteriores a 6.0.

Especifica la query con distinct

El siguiente ejemplo devuelve los valores únicos para el campo skue incrusta en el campo item, de los documentos cuyo dept es igual a "A":

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

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

{
  "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:

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.