Executar uma query de pesquisa do MongoDB

Visão geral

Neste guia, você pode aprender como usar o driver Go para executar queries de pesquisa MongoDB em uma coleção. O MongoDB Search permite realizar pesquisas de texto completo em coleções hospedadas no MongoDB Atlas. Os índices de pesquisa do MongoDB especificam o comportamento da pesquisa e quais campos indexar.

Dados de amostra

O exemplo neste guia utiliza a coleção do movies no banco de dados do sample_mflix a partir do conjunto de dados de amostra do Atlas. Para aprender como criar um cluster MongoDB Atlas gratuito e carregar os conjuntos de dados de amostra, consulte o MongoDB Get Started guia.

Executar uma query de pesquisa do MongoDB

Esta seção mostra como criar um pipeline de agregação para executar uma query do MongoDB Search em uma coleção.

Para executar uma query de pesquisa do MongoDB Search, você deve criar um índice de pesquisa do MongoDB Search em sua coleção. Para saber como criar programaticamente um índice de pesquisa do MongoDB Search, consulte a seção MongoDB Search e MongoDB Vector Search Indexes do guia Índices.

Depois de criar um índice do MongoDB Search, adicione o estágio $search ao array de estágios do pipeline para especificar os critérios de pesquisa. Em seguida, chame o método Aggregate() e passe seu array de pipeline como parâmetro.

Dica

Para saber mais sobre as operações de agregação, consulte o Guia de agregação.

Observação

Requisitos da versão do Atlas e Community Edition

O operador de pipeline de agregação $search está disponível somente para coleções hospedadas em clusters do MongoDB Atlas que executam o MongoDB v4.2 ou posterior, ou em clusters do MongoDB Community Edition que executam o MongoDB v8.2 ou posterior. As coleções devem ser cobertas por um índice de pesquisa do MongoDB. Para saber mais sobre a configuração necessária e a funcionalidade desse operador, consulte a documentação do MongoDB pesquisa.

Exemplo de pesquisa do MongoDB

Este exemplo executa uma query de pesquisa do MongoDB Search executando as seguintes ações:

Cria um estágio $search que instrui o driver a fazer query de documentos nos quais o campo title contém a palavra "Alabama"
Cria uma etapa $project que instrui o driver a incluir o campo title nos resultados da consulta
Passa as fases do pipeline para o método Aggregate() e imprime os resultados

// Defines the pipeline
searchStage := bson.D{{"$search", bson.D{
	{"text", bson.D{
		{"path", "title"},
		{"query", "Alabama"},
	}},
}}}
projectStage := bson.D{{"$project", bson.D{{"title", 1}}}}
// Runs the pipeline
cursor, err := collection.Aggregate(ctx, mongo.Pipeline{searchStage, projectStage})
if err != nil {
	panic(err)
}
// Prints the results
var results []bson.D
if err = cursor.All(ctx, &results); err != nil {
	panic(err)
}
for _, result := range results {
	fmt.Println(result)
}

{
  _id: new ObjectId('...'),
  title: 'Alabama Moon'
}
{
  _id: new ObjectId('...'),
  title: 'Crazy in Alabama'
}
{
  _id: new ObjectId('...'),
  title: 'Sweet Home Alabama'
}

Informações adicionais

Para saber mais sobre o MongoDB Search, consulte os guias MongoDB Search e a referência do estágio do pipeline $search na documentação do Atlas.

Documentação da API

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

Voltar

Séries temporais

MongoDB Vector Search