Ler operações

Visão geral

Neste guia, você pode ver modelos de código de métodos comuns que podem ser usados para ler dados do MongoDB usando o Laravel MongoDB.

encontrar um

O seguinte código mostra como recuperar o primeiro documento correspondente de uma coleção:

SampleModel::where('<field name>', '<value>')
    ->first();

Para visualizar um exemplo executável que localiza um documento, consulte o exemplo de uso Localizar um Documento.

Para saber mais sobre a recuperação de documentos e o método first(), consulte o guia Recuperar dados.

Encontrar vários

O seguinte código mostra como recuperar todos os documentos que correspondem a um filtro de query de uma coleção:

SampleModel::where('<field name>', '<value>')
    ->get();

Para visualizar um exemplo executável que localiza documentos, consulte o exemplo de uso Localizar vários documentos.

Para saber mais sobre como recuperar documentos, consulte o guia Recuperar dados.

Retornar todos os documentos

O seguinte código mostra como recuperar todos os documentos de uma coleção:

SampleModel::get();
// Or, use the all() method.
SampleModel::all();

Para visualizar um exemplo executável que localiza documentos, consulte o exemplo de uso Localizar vários documentos.

Para saber mais sobre como recuperar documentos, consulte o guia Recuperar dados.

Texto de pesquisa

O seguinte código mostra como realizar uma full text search em um campo de string nos documentos de uma collection:

SampleModel::where('$text', ['$search' => '<search term or phrase>'])
    ->get();

Para saber mais sobre como pesquisar em campos de texto, consulte o guia Pesquisar texto.

Contagem de documentos

O seguinte código mostra como contar documentos em uma coleção:

SampleModel::count();
// You can also count documents that match a filter.
SampleModel::where('<field name>', '<value>')
    ->count();

Para visualizar um exemplo executável que conta documentos, consulte o exemplo de uso Contagem de documentos.

Retrieve Distinct Values

O seguinte código mostra como recuperar os valores distintos de um campo especificado:

SampleModel::select('<field name>')
    ->distinct()
    ->get();

Para exibir um exemplo executável que retorna valores de campo distintos, consulte o exemplo de uso Retrieve Distinct Field Values (Recuperar valores de campo distintos).

Ignorar resultados

O seguinte código mostra como ignorar um número específico de documentos retornados do MongoDB:

SampleModel::where('<field name>', '<value>')
    ->skip(<number to skip>)
    ->get();

Para saber mais sobre como modificar a forma como o Laravel MongoDB retorna resultados, consulte o guia Modificar resultados da query.

Limitar resultados

O seguinte código mostra como retornar somente um número específico de documentos do MongoDB:

SampleModel::where('<field name>', '<value>')
    ->take(<number to return>)
    ->get();

Para saber mais sobre como modificar a forma como o Laravel MongoDB retorna resultados, consulte o guia Modificar resultados da query.

Classificar resultados

O seguinte código mostra como definir uma ordem de classificação nos resultados retornados do MongoDB:

SampleModel::where('field name', '<value>')
    ->orderBy('<field to sort on>')
    ->get();

Para saber mais sobre como modificar a forma como o Laravel MongoDB retorna resultados, consulte o guia Modificar resultados da query.

Definir uma preferência de leitura

O seguinte código mostra como definir uma preferência de leitura ao executar uma operação de busca:

SampleModel::where('field name', '<value>')
    ->readPreference(ReadPreference::SECONDARY_PREFERRED)
    ->get();

Para saber mais sobre as preferências de leitura, consulte o guia Como definir uma preferência de leitura.