Menu Docs
Página inicial do Docs
/
MongoDB Atlas
/
Atlas Search
/
Crie e execute consultas

Executar queries de pesquisa do Atlas

Nesta página

  • Ver modelo de orientação de query
  • No Atlas, Go para a página Clusters do seu projeto.
  • Acesse a página do Atlas Search do seu cluster.
  • Veja o modelo de orientação de query.
  • Executar queries de pesquisa do Atlas no testador de pesquisa
  • Pré-requisitos
  • Pesquise sua coleção
  • Visualizar, editar ou copiar sintaxe da query
  • Execute as Queries de Pesquisa do Atlas no Compass, Drivers e mongosh

Você pode executar queries de Atlas Search no Search Tester, Compass, Drivers e mongosh. o Atlas Search também fornece orientações de query na UI do Atlas.

Dica

Teste rapidamente o Atlas Search sem precisar de uma conta, cluster ou coleção do Atlas, com o Atlas Search Playground. Para saber mais, consulte a documentação.

Ver modelo de orientação de query

O Atlas Search fornece um modelo de query composto de amostra com orientação. O modelo mostra como criar uma query composta e a definição de índice para esta query. Veja um exemplo de tutorial em Como executar queries compostas no Atlas Search com campos ponderados.

Para ver este modelo de orientação de query:

1

In Atlas, go to the Clusters page for your project.

  1. Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.

  2. Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.

  3. If it's not already displayed, click Clusters in the sidebar.

    A página Clusters é exibida.

2

Acesse a página do Atlas Search do seu cluster.

Você pode acessar a página do Atlas Search pela barra lateral, pelo Data Explorer ou pela página de detalhes do cluster.

  1. Na barra lateral, clique em Atlas Search sob o título Services.

  2. No menu suspenso Select data source, selecione seu cluster e clique em Go to Atlas Search.

    A página Atlas Search é exibida.

  1. Clique no botão Browse Collections para o seu cluster.

  2. Expanda o banco de dados e selecione a coleção.

  3. Clique na guia Search Indexes da coleção.

    A página Atlas Search é exibida.

  1. Clique no nome do seu cluster.

  2. Clique na aba Atlas Search.

    A página Atlas Search é exibida.

3

Veja o modelo de orientação de query.

  1. Clique em View Compound Query Example.

  2. Abra cada operador para saber mais.

  3. Clique em View Index Definition para ver a definição de amostra.

Executar queries de pesquisa do Atlas no testador de pesquisa

O recurso Search Tester na guia Atlas Search permite a você:

  • Insira o termo para pesquisar na coleção.

  • Execute uma query do $search ou $searchMeta . Por padrão, o Search Tester mostra uma query básica de curinga.

  • Visualize, edite e copie sua sintaxe de consulta do Atlas Search, que você pode então executar no mongosh ou MongoDB Compass.

    Dica

    Atlas Search também fornece modelos para queries populares do Atlas Search que você pode adaptar.

Para queries do $search, o Search Tester retorna os 10 principais documentos classificados com base na pontuação de relevância. Para queries do $searchMeta, o Search Tester mostra um documento meta.

Pré-requisitos

Para utilizar o Search Tester na interface de usuário do Atlas, você deve ter o seguinte:

  • Um Atlas cluster executando o MongoDB versão 4.2 ou superior.

  • Índice do Atlas Search em sua coleção no Atlas cluster.

Pesquise sua coleção

1

In Atlas, go to the Clusters page for your project.

  1. Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.

  2. Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.

  3. If it's not already displayed, click Clusters in the sidebar.

    A página Clusters é exibida.

2

Acesse a página do Atlas Search do seu cluster.

Você pode acessar a página do Atlas Search pela barra lateral, pelo Data Explorer ou pela página de detalhes do cluster.

  1. Na barra lateral, clique em Atlas Search sob o título Services.

  2. No menu suspenso Select data source, selecione seu cluster e clique em Go to Atlas Search.

    A página Atlas Search é exibida.

  1. Clique no botão Browse Collections para o seu cluster.

  2. Expanda o banco de dados e selecione a coleção.

  3. Clique na guia Search Indexes da coleção.

    A página Atlas Search é exibida.

  1. Clique no nome do seu cluster.

  2. Clique na aba Atlas Search.

    A página Atlas Search é exibida.

3

No índice onde você deseja fazer a query, clique no botão Query no lado direito do cartão.

4

Pesquise na coleção.

  1. Insira o termo para pesquisar na caixa de pesquisa.

  2. Clique em Search para pesquisar na collection.

Visualizar, editar ou copiar sintaxe da query

1

Clique em Edit Query para visualizar sua sintaxe de query no formato JSON.

2

Opcionalmente, crie uma query a partir de um modelo existente.

Atlas Search fornece modelos para queries populares do Atlas Search . Para usar um modelo:

  1. Clique Create Query From Template. Atlas Search exibe uma lista de tipos populares do Atlas Search .

  2. Para um determinado tipo de Atlas Search , selecione um modelo no menu suspenso Template.

  3. Clique em Insert para o modelo que deseja adicionar.

3

Edite ou copie sua sintaxe de query.

Você pode editar ou copiar a sintaxe de query no formato JSON.

  1. Editar sintaxe de query

    Você pode modificar ou substituir a query exibida no Editor de Query e testar sua query clicando no botão Search.

    Importante

    Quando terminar de editar sua query, copie-a. Após você clicar em Exit Query Editor, a UI do Atlas descartará suas alterações.

  2. Copiar sintaxe de consulta

    Clique em para copiar a sintaxe de consulta no formato JSON na área de transferência. Você pode executar a consulta copiada no mongosh ou MongoDB Compass após conectar ao cluster do Atlas.

4

Click Exit Query Editor to exit the Query Editor modal.

Observação

A UI do Atlas descarta suas alterações quando você sai do Editor de Query.

Execute as Queries de Pesquisa do Atlas no Compass, Drivers e mongosh

Para executar uma query no Atlas Search, você deve ter o seguinte:

  • Um Atlas cluster executando o MongoDB versão 4.2 ou superior.

  • Índice do Atlas Search em sua coleção no Atlas cluster.

  • Uma conexão com o cliente que deseja usar para executar a query.

A página Etapa 2: Executar consultas do Atlas Search demonstra como conectar ao seu cluster do Atlas e executar consultas $search na coleção sample_mflix.movies utilizando os seguintes clientes. Para saber mais, selecione um cliente usando o menu suspenso Selecione a linguagem na página Etapa 2: Executar consultas no Atlas Search.

Cliente
Passos

MongoDB Compass

  1. Instalar e consulte Conectar via Compass para conectar ao seu cluster do Atlas utilizando o MongoDB Compass.

  2. Na aba MongoDB Compass Aggregations, insira manualmente seu pipeline de agregação.

Para saber mais, consulte Construtor de pipeline de agregação.

Drivers

  1. Instale qualquer um dos seguintes drivers:

  2. Consulte Conectar via drivers para se conectar ao Atlas cluster usando o driver instalado.

  3. Defina e execute um pipeline de agregação em seu editor de código.

Para saber mais sobre como executar queries $search usando esses drivers, consulte Etapa 2: Executar consultas do Atlas Search. Cada exemplo na página Etapa 2: Executar Queries de Pesquisa do Atlas executa o seguinte:

  • Cria uma ligação ao seu Atlas cluster com o MongoClient.

  • Define um pipeline.

  • Executa o pipeline.

  • Imprime o resultado da query.

MongoDB Shell

  1. Instale e consulte Conectar via mongosh para conectar-se ao seu cluster do Atlas utilizando o MongoDB Shell.

  2. Define e execute uma consulta do Atlas Search.

Para mais informações sobre executar consultas do $search utilizando mongosh, consulte Etapa 2: Executar Consultas de Pesquisa do Atlas.

Voltar

7. Devolver campos de origem armazenados

Próximo

Explicar plano e estatísticas