Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

Consultar documentos

Nesta página, você pode ver exemplos de código copiáveis que mostram métodos comuns de driver Ruby que você pode usar para ler dados do MongoDB.

Dica

Para saber mais sobre qualquer um dos métodos mostrados nesta página, consulte o link fornecido em cada seção.

Para usar um exemplo desta página, copie o exemplo de código no Aplicativo de Exemplo abaixo ou em seu próprio aplicação. Certifique-se de substituir todos os espaços reservados nos exemplos de código, como <connection string URI>, pelos valores relevantes para sua implantação do MongoDB .

Você pode usar o seguinte aplicativo de exemplo para testar os exemplos de código nesta página. Para usar o aplicativo de amostra, execute as seguintes etapas:

  1. Verifique se o driver Ruby está instalado em seu projeto Ruby .

  2. Copie o seguinte código e cole-o em um novo arquivo .rb .

  3. Copie um exemplo de código desta página e cole-o nas linhas especificadas no arquivo.

require 'bundler/inline' gemfile do source 'https://rubygems.org' gem 'mongo'end uri = '<connection string>' Mongo::Client.new(uri) do |client| database = client.use('<database name>') collection = database['<collection name>'] # Start example code here # End example code hereend

O exemplo a seguir recupera um documento que corresponde aos critérios especificados pelo filtro fornecido:

document = collection.find(name: '<value>').firstputs document

Para saber mais sobre o método first , consulte o guia Recuperar dados .

O exemplo a seguir recupera todos os documentos que correspondem aos critérios especificados pelo filtro fornecido:

results = collection.find(founded_year: '<value>')

Para saber mais sobre o método find , consulte o guia Recuperar dados .

O exemplo a seguir retorna o número de documentos na coleção especificada:

result = collection.count_documentsputs "Number of documents: #{result}"

Para saber mais sobre o método count_documents , consulte o guia Contagem de documentos .

O exemplo a seguir retorna o número de documentos na coleção especificada que correspondem aos critérios de consulta:

result = collection.count_documents('key': '<value>')puts "value: #{result}"

Para saber mais sobre o método countDocuments() , consulte o guia Contagem de documentos .

O exemplo a seguir retorna um número aproximado de documentos na collection especificada com base nos metadados da collection:

result = collection.estimated_document_countputs "Estimated number of documents: #{result}"

Para saber mais sobre o método estimated_document_count() , consulte o guia Contagem de documentos .

O exemplo a seguir retorna todos os valores distintos do nome do campo especificado em uma determinada coleção:

results = collection.distinct('field')

Para saber mais sobre o método distinct , consulte o guia Retrieve Distinct Field Values (Recuperar valores de campos distintos).

O exemplo a seguir cria um change stream para uma determinada collection e imprime eventos de alteração subsequentes nessa collection:

stream = collection.watchcollection.insert_one(a: 1)doc = stream.firstprocess(doc)

Para saber mais sobre o método watch() , consulte o guia Monitorar alterações de dados .