distinct (comando de banco de dados)

Campos de array

Se o valor do especificado field for uma array, considera cada elemento da array como um valordistinct separado.

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

Iniciando no MongoDB,6.0 o comando retorna os distinct mesmos resultados para collections e visualizações ao utilizar 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 podem utilizardistinct índices.

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

Transações

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

• Para coleções não fragmentadas, você pode usar o db.collection.distinct() método /o distinct command, bem como o pipeline de agregação com o $group stage.

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

  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

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

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

Para executar em um membro do conjunto de réplicas, distinct as operações do exigem que o membro esteja no estado ou.PRIMARY Se o membro estiver em SECONDARY STARTUP2 outro estado, como, os erros de 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 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
}

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

Arrays em collections e visualizações

Iniciando no MongoDB,6.0 o comando retorna os distinct mesmos resultados para collections e visualizações ao utilizar 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 para retornar os valores exclusivos distinct da temperatures array na 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.