Menu Docs

Página inicial do Docs → Iniciar e gerenciar o MongoDB → MongoDB Atlas

Como usar as Facetas com Atlas Search

Nesta página

  • Pré-requisitos
  • Criar o índice do Atlas Search para facet
  • Pesquisar a collection
  • Continuar aprendendo

Este tutorial descreve como criar um índice com uma definição de faceta em campos de string, data e numéricos na collection sample_mflix.movies. Ele mostra como executar uma query do Atlas Search nesses campos para resultados agrupados por valores para o campo de string e por faixas para os campos de data e numéricos, incluindo a contagem para cada um desses grupos. Ele conduz você pelas seguintes etapas:

  1. Configure um índice do Atlas Search com definição de facet nos campos genres, released e year na collection sample_mflix.movies.

  2. Execute a query do Atlas Search no campo released da collection sample_mflix.movies para obter resultados agrupados por valores para o campo genres e por faixas para o campo year.

Para criar um índice do Atlas Search, você deve ter acesso do Project Data Access Admin ou superior ao projeto.

Pré-requisitos

Para completar estes tutoriais, além dos pré-requisitos listados na página Tutoriais do Atlas Search, você deve ter um Atlas cluster executado em uma das seguintes versões:

  • MongoDB 5,0,4+

  • MongoDB 6.0+

  • MongoDB 7.0+

Criar o índice do Atlas Search para facet

Nesta seção, você criará um índice do Atlas Search nos campos genres, year e released na collection sample_mflix.movies.

1

Navegue até a página do Atlas Search referente ao seu projeto.

  1. Se ainda não estiver exibido, selecione a organização que contém seu projeto desejado 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. Clique no nome do seu cluster.

  4. Clique na aba Atlas Search.

2

Clique Create Search Index.

3

Selecione um Atlas Search Configuration Method e clique Next.

  • Para uma experiência abada, selecione a Pesquisa Atlas Visual Editor.

  • Para editar a definição de índice bruto, selecione a Pesquisa Atlas JSON Editor.

4

Insira o Index Name e defina o Database and Collection.

  1. No campo Index Name, digite facet-tutorial.

    Observação

    Se você nomear seu índice como default, não precisará especificar um parâmetro index ao usar o estágio do pipeline $search. Caso contrário, você deve especificar o nome do índice utilizando o parâmetro index.

  2. Na seção Database and Collection, localize o banco de dados sample_mflix e selecione a coleção movies.

5

Especifique uma definição de índice.

A definição do índice a seguir usa lucene.standard como analyzer padrão para indexação e query dos campos e especifica o seguinte para os campos a serem indexados:

Nome do campo
Tipo de Dados
genres
stringFacet
year
Faceta numérica
released
data

Você pode usar o Visual Editor do Atlas Search ou o JSON Editor do Atlas Search na interface de usuário do Atlas para criar o índice.

6

Clique Create Search Index.

7

Feche a janela modal You're All Set! .

Uma janela modal é exibida para que você saiba que seu índice está construindo. Clique no botão Close.

8

Aguarde o índice para concluir a formação.

O índice deve levar cerca de um minuto para ser criado. Enquanto está se formando, a coluna Status mostra Build in Progress. Quando terminar de se formar, a coluna Status mostrará Active.

Pesquisar a collection

➤ Use o menu suspenso Selecione a linguagem para definir a linguagem dos exemplos desta seção.

Você pode usar facet nas queries que usam os estágios $search e $searchMeta. Nesta seção, conecte-se ao seu Atlas cluster e execute a query de amostra na collection sample_mflix.movies usando o estágio $searchMeta. O MongoDB recomenda o uso do estágio $searchMeta para recuperar somente os resultados dos metadados.

Os resultados mostram resultados de metadados para dois tipos de pesquisa de facet. O documento genresFacet mostra o número de filmes em cada gênero e o documento yearFacet mostra a contagem de filmes dentro dos limites:

  • 1910, incluindo o limite inferior do intervalo 1910

  • 1920, limite superior exclusivo para o bucket 1910 e limite inferior inclusivo para o bucket 1920

  • 1930, limite superior exclusivo para o bucket 1920 e limite inferior inclusivo para o bucket 1930

Continuar aprendendo

Você pode aprender mais sobre faceta no Atlas Search com nossocurso ou vídeo .

Aprenda com cursos

Para saber mais sobre o uso de facets no Atlas Search, faça a Unidade 9 do Curso de Introdução ao MongoDB na MongoDB University. O 1. A unidade 5 horas inclui uma visão geral do Atlas Search e lições sobre como criar índices do Atlas Search, executar consultas $search usando operadores compostos e agrupar resultados usando facet.

Aprenda com vídeos

Acompanhe este vídeo para saber como criar e usar uma faceta numérica e de cadeia de caracteres em sua query para agrupar resultados e recuperar uma contagem dos resultados nos grupos.

Duração: 11 Minutos

← Como usar o preenchimento automático com o Atlas Search
Como usar sinônimos com o Atlas Search →

Nesta página