distinct (comando de banco de dados)

Campos de array

If the value of the specified field is an array, distinct considers each element of the array as a separate value.

For instance, if a field has as its value [ 1, [1], 1 ], then distinct considers 1, [1], and 1 as separate values.

Starting in MongoDB 6.0, the distinct command returns the same results for collections and views when using arrays.

Para exemplos, consulte:

• Valores Distintos de Retorno para um Campo de Array

• Arrays em collections e visualizações

Uso do índice

When possible, distinct operations can use indexes.

Indexes can also cover distinct operations. See Run Covered Queries for more information on queries covered by indexes.

Transações

Para realizar uma operação distinta dentro de uma transação:

• For unsharded collections, you can use the db.collection.distinct() method/the distinct command as well as the aggregation pipeline with the $group stage.

• For sharded collections, you cannot use the db.collection.distinct() method or the distinct command.

  Para encontrar os valores distintos de uma pipeline de agregação fragmentada, use o pipeline de agregação com o estágio $group. Consulte Operação Distinta para detalhes.

Desconexão do cliente

If the client that issued distinct disconnects before the operation completes, MongoDB marks distinct for termination using killOp.

Restrição de estado do membro do conjunto de réplica

To run on a replica set member, distinct operations require the member to be in PRIMARY or SECONDARY state. If the member is in another state, such as STARTUP2, the operation errors.

Filtros e Agrupamentos de Índice

Iniciando no MongoDB 6.0, um filtro de índice utiliza a coleção definida anteriormente utilizando o comando planCacheSetFilter.

Valores Distintos de Devolução para um Campo

O exemplo a seguir retorna valores dept distintos da coleção inventory:

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

O comando retorna um documento com um campo values contendo os valores dept distintos:

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

Valores Distintos de Retorno para um Campo Incorporado

O exemplo a seguir retorna valores distintos para o campo incorporado item.sku da coleção inventory:

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

O comando retorna um documento com um campo values contendo os valores sku distintos:

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

Valores Distintos de Retorno para um Campo de Array

O exemplo a seguir retorna valores sizes distintos da coleção inventory:

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

O comando retorna um documento com um campo values contendo os valores sizes distintos:

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

For information on distinct and array fields, see the Behavior section.

Arrays em collections e visualizações

Starting in MongoDB 6.0, the distinct command returns the same results for collections and views when using arrays.

O exemplo a seguir cria uma collection chamada sensor com uma array 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 } ] }
] )

O exemplo seguinte cria uma visualização denominada sensorView a partir da collection sensor:

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

The following example uses distinct to return the unique values from the temperatures array in the sensor collection:

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

O 1 em temperatures.1.value especifica o índice da array temperatures.

Saída de exemplo:

[ 4, 8, 12 ]

Exemplo para sensorView:

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

Saída de exemplo:

• [ 4, 8, 12 ] começando no MongoDB 6.0 (idêntico ao resultado retornado da collection sensor ).

• [] em versões MongoDB anteriores a 6.0.

Especificar query com distinct

O exemplo a seguir retorna valores distintos para o campo item.sku incorporado em que dept é igual a "A":

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

O comando retorna um documento com um campo values contendo os valores sku distintos:

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

Especificar um agrupamento

A colocação permite que os usuários especifiquem regras específicas do idioma para comparação de strings, como regras para letras maiúsculas e marcas de acento.

Uma coleção myColl possui os seguintes documentos:

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

A seguinte operação de aggregation inclui a opção Agrupamento:

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

Para obter descrições sobre os campos de agrupamento, consulte Documento de agrupamento.

Substituir o Padrão Atenção com a Leitura

Para substituir o nível de preocupação de leitura padrão do "local", utilize a opção readConcern.

A operação a seguir em um conjunto de réplicas especifica uma read concern de "majority" para ler a cópia mais recente dos dados confirmados como tendo sido gravados na maioria dos nós.

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

Para garantir que um único thread possa ler suas próprias gravações, use "majority" read concern e "majority" write concern em relação ao primário do conjunto de réplicas.