Criar e Gerenciar Índices de Pesquisa do Atlas
Nesta página
Um índice do Atlas Search é uma estrutura de dados que categoriza os dados em um formato facilmente pesquisável. É um mapeamento entre os termos e os documentos que contêm esses termos. Os índices do Atlas Search permitem a recuperação mais rápida de documentos usando determinados identificadores. Você deve configurar um índice do Atlas Search para fazer query em dados em seu cluster Atlas usando o Atlas Search.
Você pode criar um índice de Pesquisa do Atlas em um único campo ou em múltiplos campos. Recomendamos que você indexe os campos que usa regularmente para classificar ou filtrar seus dados para recuperar rapidamente os documentos que contêm os dados relevantes em tempo de query.
Você pode especificar os campos para indexar utilizando os seguintes métodos:
Mapeamentos dinâmicos, que permitem que o Atlas Search indexe automaticamente todos os campos dos tipos suportados em cada documento. Isso pode desperdiçar espaço em disco para indexar campos que você nunca pesquisaria e afetar negativamente o desempenho do cluster.
Mapeamentos estáticos, que permitem que você identifique seletivamente os campos para indexar. Se os campos contiverem dados polimórficos, a Atlas Search indexará apenas os documentos que correspondem ao mapeamento na definição de índice e ignorará os documentos que contêm valores que não correspondem ao mapeamento especificado na definição de índice para os campos.
Considerações
Embora os dados armazenados no Atlas Search não sejam uma cópia idêntica dos dados da collection no seu cluster do Atlas, os índices do Atlas Search ainda ocupam algum espaço em disco e memória. Se você habilitar a opção store para campos que contêm valores de string ou se você configurar os campos de origem armazenados no seu índice, o Atlas Search armazenará uma cópia idêntica dos campos especificados no disco, que podem ocupar espaço em disco.
Ao utilizar índices de Atlas Search , você pode experimentar um consumo elevado de recursos em um nó ocioso para seu agrupamento do Atlas . Isso se deve ao processo mongot subjacente, que executa várias operações essenciais para o Atlas Search. A utilização da CPU em um nó ocioso pode variar dependendo do número, complexidade e tamanho dos índices.
Observação
O Atlas Search não aceita a criptografia de índices do Atlas Search com chaves de criptografia usando o Gerenciamento de chave de cliente na UI do Atlas.
O Atlas Search oferece analisadores integrados para a criação de termos indexáveis que corrigem as diferenças de pontuação, capitalização, palavras vazias e muito mais. Os analisadores aplicam regras de análise e linguagem à query. Você também pode criar um analisador personalizado usando filtros de caracteres, tokenizadores e filtros de token integrados disponíveis ee integrados. Para saber mais sobre os analisadores internos e personalizados, consulte Process Data with analyzers.
Para saber mais sobre o suporte da Atlas Search para outros tipos de dados, consulte Tipos de dados. O processo mongot armazena os campos indexados e o campo _id no disco por índice para as coleções no cluster.
Se você fizer alterações na collection para a qual definiu os índices da Atlas Search, os dados mais recentes podem não estar disponíveis imediatamente para query. No entanto, o mongot monitora os fluxos de alterações, o que permite atualizar cópias armazenadas de dados, e os índices de Atlas Search são eventualmente consistentes.
Quando você altera uma definição de índice, mongot reconstrói automaticamente o novo índice em segundo plano, enquanto continua a atender consultas com o índice antigo para garantir que não haja tempo de inatividade. Isso acontece quando você implanta os processos mongot e mongod no mesmo nó e quando implanta os processos em nós diferentes.
Se você alterar a topologia de sua implantação de pesquisa, o Atlas Search provisiona e cria índices em todos os novos nós antes de remover os nós antigos, para garantir que não haja tempo de inatividade da consulta.
Se as implantações em que ambos os processos mongod e mongot são executados no mesmo nó, quando o Atlas Search introduz alterações que exigem a reconstrução dos seus índices (como alguns recursos do Atlas Search que exigem uma atualização de índice), o Atlas implanta automaticamente nós adicionais gratuitamente para criar os índices, enquanto os nós antigos continuam a atender às suas queries.
Observação
Para Nós de Pesquisa Dedicados
Adicionar e ajustar fragmentos aciona uma reconstrução do índice de Atlas Search. Durante a reconstrução do índice, o índice talvez não tenha os dados mais atuais. Portanto, queries em relação aos dados nesses fragmentos podem falhar ou retornar resultados incorretos.
Se você refragmentar uma coleção com índices do Atlas Search, os índices |fts| na coleção ficarão indisponíveis quando a operação de refragmentação estiver completa. Você deve excluir e criar novos índices do Atlas Search assim que a operação for concluída.
Se você emitir o comando para alterar o fragmento primário de um banco de dados, os índices do Atlas Search para qualquer coleção não fragmentada nesse banco de dados ficarão indisponíveis após a conclusão da operação. Você deve excluir e criar novos índices do Atlas Search assim que a operação movePrimary for concluída.
Você prefere aprender assistindo?
Assista a este vídeo para uma visão geral dos índices de Pesquisa Atlas. Neste vídeo, você pode aprender mais sobre analisadores e tipo de campo autocomplete do Atlas Search.
Duração: 8 Minutos
Clientes aceitos
Você pode criar e gerenciar índices do Atlas Atlas Search a partir da IU do Atlas, API do Atlas Search , Atlas CLI do Atlas , mongosh, MongoDB Compass e drivers MongoDB .
Atlas CLI
Para criar e gerenciar índices do Atlas Search com o Atlas CLI, seu cluster do Atlas precisa rodar no MongoDB versão 6.0+ ou 7.0+.
mongosh
Para criar e gerenciar índices do Atlas Search usando mongosh, seu cluster do Atlas deve executar o MongoDB 6.0+ ou 7.0+.
MongoDB Compass
Para criar e gerenciar índices do Atlas Search usando o Compass, seu cluster do Atlas deve executar o MongoDB 7.0+.
MongoDB Drivers
Para criar e gerenciar índices do Atlas Search programaticamente em qualquer camada do cluster, você pode usar qualquer um dos seguintes drivers do MongoDB :
Driver do MongoDB | Versão |
|---|---|
1.25.0 ou superior | |
3.9.0 ou superior | |
2.21.0 ou superior | |
1.13.0 ou superior | |
4.11.0 ou superior | |
9.0 ou superior | |
3.3.0 ou superior | |
5.2.0 ou superior | |
5.6.0 ou superior | |
1.17.0 ou superior | |
4.5 ou superior | |
2.19.2 ou superior | |
2.8.0 ou superior | |
5.2.0 ou superior |
Próximos passos
Para saber como criar um índice do Atlas Search, consulte Criar um índice do Atlas Search. Para ter experiência prática com a criação de índices do Atlas Search para os conjuntos de dados de amostra e na execução de queries do Atlas Search nos dados indexados, confira os tutoriais nas páginas a seguir: