distinct (comando de banco de dados)

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 operações distinct. 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:

• 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

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.

A partir do MongoDB 8.0, use configurações de query em vez de adicionar filtros de índice. Os filtros de índice estão obsoletos a partir do MongoDB 8.0.

As configurações de query têm mais funcionalidades do que os filtros de índice. Além disso, os filtros de índice não são persistentes e você não pode criar facilmente filtros de índice para todos os nós de cluster. Para adicionar configurações de query e explorar exemplos, consulte setQuerySettings.

Configurações de query

Você pode usar as configurações de query para definir dicas de índice, definir filtros de descarte de operação e outros campos. As configurações se aplicam à forma de query em todo o cluster. O cluster mantém as configurações após o fechamento.

O otimizador de query usa as configurações da query como uma entrada adicional durante o planejamento da query, o que afeta o plano selecionado para executar a query. Você também pode usar as configurações de query para bloquear uma forma de query.

Para adicionar configurações de query e explorar exemplos, consulte setQuerySettings.

Você pode adicionar configurações de query para os comandos find, distinct e aggregate.

As configurações de consulta têm mais funcionalidade e são preferidas em relação aos filtros de índice obsoletos.

Para remover as configurações de query, use removeQuerySettings. Para obter as configurações de consulta, use um estágio $querySettings em um pipeline de agregação .

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

Especificar um índice

Você pode especificar um nome ou padrão de índice usando a opção dica.

Para especificar uma dica com base em um nome de índice:

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

Para especificar uma dica com base em um padrão de índice:

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