distinto

Campos de array

Se o valor do field especificado for uma array, distinct considerará cada elemento dela como um valor separado.

Por exemplo, se um campo tiver como seu valor [ 1, [1], 1 ], então distinct considera 1, [1] e 1 como valores separados.

A partir do MongoDB 6.0, o comando distinct retorna os mesmos resultados para coleções e visualizações ao usar arrays.

Para exemplos, consulte:

• Valores Distintos de Retorno para um Campo de Array

• Arrays em collections e visualizações

Uso do índice

Quando possível, as operações do distinct podem usar índices.

Os índices também podem abranger as operações distinct. Consulte Query coberta para obter mais informações sobre as queries cobertas por índices.

Transações

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

• No caso das coleções não fragmentadas, você pode usar o método db.collection.distinct() ou o comando distinct, bem como o pipeline de agregação com o estágio $group.

• Para coleções fragmentadas, você não pode utilizar o método db.collection.distinct() ou o comando distinct .

  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

A partir do MongoDB 4.2, se o cliente que emitiu distinct se desconectar antes da conclusão da operação, o MongoDB marcará distinct para encerramento usando killOp.

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

Para executar em um membro do conjunto de réplicas, as operações dedistinct exigem que o membro esteja no estado PRIMARY ou SECONDARY. Se o membro estiver em outro estado, como STARTUP2, ocorre um erro na operação.

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 os valores distintos para o campo dept de todos os documentos na coleção inventory:

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

O comando retorna um documento com um campo denominado values que contém os valores distintos do dept:

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

Valores Distintos de Retorno para um Campo Incorporado

O exemplo seguinte retorna os valores distintos para o campo sku, embutido no campo item, de todos os documentos na coleção inventory:

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

O comando retorna um documento com um campo denominado values que contém os valores distintos do sku:

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

Valores Distintos de Retorno para um Campo de Array

O exemplo a seguir retorna os valores distintos para o campo sizes de todos os documentos na coleção inventory:

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

O comando retorna um documento com um campo denominado values que contém os valores distintos do sizes:

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

Para obter informações sobre distinct e os campos da array, consulte a seção Comportamento.

Arrays em collections e visualizações

A partir do MongoDB 6.0, o comando distinct retorna os mesmos resultados para coleções e visualizações ao usar 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", [] )

O exemplo a seguir usa distinct para retornar os valores exclusivos da array temperatures na coleção sensor:

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 seguinte retorna os valores distintos para o campo sku, embutido no campo item, a partir dos documentos cujo dept é igual a "A":

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

O comando retorna um documento com um campo denominado values que contém os valores distintos do sku:

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