/ /

MongoDB Search

Visão geral

Neste guia, você aprenderá a fazer pesquisas em seus documentos usando o recurso de pesquisa do MongoDB . O Laravel MongoDB fornece uma API para realizar queries do MongoDB Search diretamente em seus modelos. Este guia descreve como criar índices de pesquisa MongoDB e fornece exemplos de como usar a integração Laravel para realizar pesquisas.

Observação

Compatibilidade de implantação

Você pode usar a funcionalidade MongoDB Search somente quando se conectar a clusters do MongoDB Atlas . Esta funcionalidade não está disponível para implementações autogerenciadas.

Para saber mais sobre o MongoDB Search, consulte a visão geral do na documentação do Atlas . A API de pesquisa do MongoDB usa internamente o $search operador de agregação para executar as queries. Para saber mais sobre este operador, consulte a referência $search na documentação do Atlas .

Observação

Talvez você não consiga usar os métodos descritos neste guia para todos os tipos de query do MongoDB Search. Para casos de uso mais complexos, crie um pipeline de agregação usando o Construtor de agregação do.

Para realizar pesquisas sobre incorporações vetoriais no MongoDB , você pode usar a API de Vector Search do MongoDB do Laravel. Para saber mais sobre esse recurso, consulte o guia Vector Search do MongoDB .

Crie um índice de pesquisa do MongoDB

Você pode criar um índice do MongoDB Search das seguintes maneiras:

Chame o create() método na Schema interface e passe o searchIndex() método assistente com detalhes de criação de índice. Para saber mais sobre essa estratégia, consulte a seção Gerenciar índices do MongoDB Search e do MongoDB Vector Search do guia Construtor de esquemas.

Acesse uma coleção, depois chame o método createSearchIndex() da Biblioteca PHP do MongoDB, conforme mostrado no código a seguir:

$collection = DB::connection('mongodb')->getCollection('movies');
$collection->createSearchIndex(
    ['mappings' => ['dynamic' => true]],
    ['name' => 'search_index']
);

Executar queries

Nesta seção, você pode aprender como usar a API de pesquisa MongoDB na integração Laravel.

Consultas gerais

A Integração Laravel fornece o método search() como um método construtor de query e como um método de modelo Eloquent. Você pode usar o método search() para executar queries do MongoDB Search em documentos em suas collections.

Você deve passar um parâmetro operator para o método search() que seja uma instância de SearchOperatorInterface ou um array que contenha o tipo de operador, o nome do campo e o valor da query. Você pode criar uma instância de SearchOperatorInterface ao chamar o método Search::text() e passar o campo que está consultando junto com seu termo ou sua frase de pesquisa.

Você deve incluir a seguinte declaração de importação em seu aplicativo para criar uma instância de SearchOperatorInterface:

use MongoDB\Builder\Search;

O seguinte código executa uma query do MongoDB Search no campo Movie do modelo title para o termo 'dream':

$movies = Movie::search(
    sort: ['title' => 1],
    operator: Search::text('title', 'dream'),
)->all();

[
   { "title": "Dreaming of Jakarta",
     "year": 1990
   },
   { "title": "See You in My Dreams",
     "year": 1996
   }
]

Você pode utilizar o método search() para executar muitos tipos de queries do MongoDB Search. Dependendo da query desejada, você pode passar os seguintes parâmetros opcionais para search():

Parâmetro opcional	Tipo	Descrição
`index`	`string`	Fornece o nome do índice de pesquisa MongoDB a ser usado
`highlight`	`array`	Especifica as opções de realce para exibir os termos de pesquisa em seu contexto original
`concurrent`	`bool`	Paraleliza a query de pesquisa entre segmentos em nós de pesquisa dedicados
`count`	`string`	Especifica as opções de contagem para recuperar uma contagem dos resultados
`searchAfter`	`string`	Especifica um ponto de referência para retornar documentos que começam imediatamente após esse ponto
`searchBefore`	`string`	Especifica um ponto de referência para retornar documentos que começam imediatamente antes desse ponto
`scoreDetails`	`bool`	Especifica se um detalhamento da pontuação para os resultados deve ser recuperado
`sort`	`array`	Especifica os campos nos quais classificar os resultados
`returnStoredSource`	`bool`	Especifica se uma pesquisa completa de documento deve ser executada no banco de dados de backend ou se deseja retornar apenas campos de origem armazenados diretamente da Pesquisa MongoDB
`tracking`	`array`	Especifica a opção de rastreamento para recuperar informações de análise sobre os termos de pesquisa

Para saber mais sobre esses parâmetros, consulte a seção Campos da referência do operador $search na documentação do Atlas.

Queries de preenchimento automático

A integração do Laravel fornece o método autocomplete() como método de construção de queries e como método de modelo Eloquent. Você pode usar o método autocomplete() para executar pesquisas de preenchimento automático em documentos das suas coleções. Este método retorna apenas os valores do campo que você especificar como caminho da query.

Para saber mais sobre esse tipo de query do MongoDB Search, consulte a referência de preenchimento automático na documentação do Atlas .

Observação

Você deve criar um índice do MongoDB Search com uma configuração de preenchimento automático em sua collection antes de poder executar pesquisas com preenchimento automático. Consulte a seção Criar um índice de pesquisa MongoDB deste guia para saber mais sobre como criar índices de pesquisa.

O código a seguir executa uma query de preenchimento automático do MongoDB Search para a string "jak" no campo title :

$movies = Movie::autocomplete('title', 'jak')->all();

[
   "Dreaming of Jakarta",
   "Jakob the Liar",
   "Emily Calling Jake"
]

Você também pode passar os seguintes parâmetros opcionais para o método autocomplete() para customizar a query:

Parâmetro opcional	Tipo	Descrição	Valor padrão
`fuzzy`	`bool` ou `array`	Permite a pesquisa difusa e as opções de pesquisa difusa	`false`
`tokenOrder`	`string`	Especifica a ordem na qual pesquisar tokens	`'any'`

Para aprender mais sobre esses parâmetros, consulte a seção Opções da referência do operador autocomplete na documentação do Atlas.

Voltar

Construtor de agregações

MongoDB Vector Search