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 usam a collection restaurants no banco de dados sample_restaurants dos conjuntos 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 aprender a criar um cluster MongoDB Atlas gratuito e carregar os conjuntos de dados de amostra, consulte o Guia de Introdução do MongoDB.
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 |
|---|---|
| O agrupamento a ser usado para a operação. |
| A quantidade máxima de tempo em milissegundos que a operação pode ser executada. |
| A preferência de leitura a ser usada na operação. Para saber mais, consulte Preferência de leitura no manual do MongoDB Server. |
| A sessão a ser usada para a operação. |
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.