Recuperar valores de campo distintos

Visão geral

Neste guia, você pode aprender a usar o driver Ruby para recuperar os valores distintos de um campo especificado em uma collection.

Dentro de uma coleção, os documentos podem conter valores diferentes para um único campo. Por exemplo, um documento em uma coleção restaurants tem um valor borough de 'Manhattan' e outro tem um valor borough de 'Queens'. Você pode usar o driver Ruby para recuperar todos os valores exclusivos que um campo contém em vários documentos em uma collection.

Dados de amostra

Os exemplos neste guia utilizam a coleção do restaurants no banco de dados do sample_restaurants a partir dosconjuntos de dados de amostra do Atlas. Para acessar essa coleção a partir do seu aplicação Ruby, crie um objeto Mongo::Client que se conecte a um Atlas cluster e atribua os seguintes valores às suas variáveis database e collection:

database = client.use('sample_restaurants')
collection = database[:restaurants]

Para saber como criar um cluster MongoDB Atlas gratuito e carregar os conjuntos de dados de amostra, consulte o guia Iniciar com Atlas .

Retrieve Distinct Values

Para recuperar os valores distintos para um campo especificado, chame o método distinct e passe o nome do campo para o qual você deseja encontrar valores distintos.

Recuperar valores em uma collection

O exemplo seguinte recupera os valores distintos do campo borough na coleção restaurants :

results = collection.distinct('borough')
results.each do |value|
  puts value
end

Bronx
Brooklyn
Manhattan
Missing
Queens
Staten Island

A operação retorna uma array que armazena cada valor de campo borough distinto. Embora vários documentos tenham o mesmo valor no campo borough , cada valor aparece nos resultados apenas uma vez.

Recuperar valores em documentos especificados

Você pode fornecer um filtro de query para o método distinct para localizar os valores de campo distintos em um subconjunto de documentos em uma coleção. Um filtro de query é uma expressão que especifica os critérios de pesquisa usados para corresponder a documentos em uma operação.

Dica

Para saber mais sobre como criar um filtro de query, consulte o guia Especificar uma query.

O exemplo a seguir recupera os valores distintos do campo borough para todos os documentos que têm um valor de campo cuisine de 'Italian':

results = collection.distinct('borough', { cuisine: 'Italian' })
results.each do |value|
  puts value
end

Bronx
Brooklyn
Manhattan
Queens
Staten Island

Modificar comportamento distinto

Você pode modificar o comportamento do método distinct passando um objeto Hash que especifica valores de opção. A tabela a seguir descreve as opções que você pode definir para personalizar a operação:

Opção	Descrição
`collation`	The collation to use for the operation. Type: `Hash`
`max_time_ms`	The maximum amount of time in milliseconds that the operation can run. Type: `Integer`
`read`	The read preference to use for the operation. To learn more, see Read Preference in the MongoDB Server manual. Type: `Hash`
`session`	The session to use for the operation. Type: `Session`

O exemplo a seguir recupera os valores distintos do campo name para todos os documentos que têm um valor de campo borough de 'Bronx' e um valor de campo cuisine de 'Pizza'. Ele também define a opção read, que instrui a operação a usar uma preferência de leitura primary_preferred :

filter = { borough: 'Bronx', cuisine: 'Pizza' }
options = { read: { mode: :primary_preferred } }
results = collection.distinct('name', filter, options)
results.each do |value|
  puts value
end

$1.25 Pizza
18 East Gunhill Pizza
2 Bros
Aenos Pizza
Alitalia Pizza Restaurant
Amici Pizza And Pasta
Angie'S Cafe Pizza
Anthony & Joe'S Pizza
Anthony'S Pizza
Antivari Pizza
Arturo'S Pizza
Bartow Pizza
...

Documentação da API

Para saber mais sobre o método distinct, consulte a documentação API.

Voltar

Especifique campos a serem retornados

Contagem de documentos