Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.
Menu Docs

Compatibilidade e limitações de pesquisa do MongoDB

This page describes the compatibility and limitations of MongoDB Search features on Atlas. For details on MongoDB Search compatibility with self-managed deployments, see Compatibility and Requirements for mongot.

Para determinados recursos, o MongoDB Search pode exigir uma versão específica do MongoDB. A tabela a seguir lista os recursos do MongoDB Search que exigem versões específicas do MongoDB .

Funcionalidade de pesquisa do MongoDB
Versão do MongoDB para recurso

8.0+

Query Views diretamente com $search e $searchMeta

8.1+

$search e $searchMeta em visualizações sharded

8.2+

$rankFusion em Visualizações

8.2+

7.0+, 8.0+

7.0+, 8.0+

7.0+, 8.0+

7.0+, 8.0+

7.0+, 8.0+

7.0+, 8.0+

7.0+, 8.0+

7.0+, 8.0+

7.0+, 8.0+

7.0+, 8.0+

$search searchAfter e searchBefore opções

6.0.13+, 7.0.5+, 8.0+

MongoDB Search is not supported for time series collections. Starting in MongoDB 8.3, the $search, $searchMeta, and $vectorSearch stages fail with an error message when run on timeseries collections. Previously, these stages returned empty results.

As seguintes limitações se aplicam somente à Pesquisa do MongoDB em clusters gratuitos e clusters flexíveis:

  • Não é possível criar mais de:

    • 3 índices (independentemente do tipo, search ou vector) em clusters gratuitos.

    • 10 índices em clusters Flex.

  • Quando você atingir o número máximo de índices permitido para a camada do cluster, poderá dimensioná- camada do cluster para criar índices adicionais. Se você dimensionar a camada do cluster, os índices serão reconstruídos na nova camada do cluster, o que acionará uma sincronização inicial.

  • Um objeto JSON de definição de índice não pode exceder 3KB.

  • Uma definição de índice pode ter somente um mapeamento de sinônimo.

  • Construções de índice com mais de 300 campos falham.

  • O limite de cláusulas padrão da Lucene de 1024 aplica-se a qualquer BooleanQuery criado para pesquisas.

  • A collection de sinônimos não pode exceder 10.000 documentos.

  • MongoDB Search doesn't support encrypting MongoDB Search indexes with encryption keys using Customer Key Management in the Atlas UI.

Observação

Você pode solicitar uma nova funcionalidade ou votar em uma solicitação existente usando o MongoDB Feedback Engine.

Para saber mais sobre as limitações do Search Playground, consulte Limitações do Search Playground.

Para saber mais sobre os clientes compatíveis, consulte Índices e queries.

If you create a MongoDB Search index that has or will soon have more than 2.1 billion index objects, you must use numPartitions or shard your cluster. For this limit, each top-level document or nested embeddedDocument in the indexed collection fields counts as one object

Por padrão, o MongoDB Search para de replicar alterações para um único índice que cresce mais de 2.1 bilhões de objetos de índice em qualquer membro ou shard do conjunto de réplicas. Isso significa que seu índice permanece consultável, mas você pode obter resultados obsoletos.

If your collection contains documents that are 16MB or larger, MongoDB Search fails to index your document, causing your index to become STALE, and initiates a full index rebuild. You must delete the offending document(s) from your collection in order for index rebuild to successfully complete. This issue can also occur when update operations on large documents cause the change stream event to exceed the 16MB BSON limit. To avoid this, we recommend that no single document in your collection exceeds 8MB. Consider the following best practices:

  • Estruture seus documentos para minimizar o tamanho de subdocumentos ou arrays.

  • Evite operações que atualizem ou substituam campos grandes, subdocumentos ou arrays.

To learn more, see Change Streams Production Recommendations and Reduce the Size of Large Documents.

Para saber mais sobre as limitações do índice, consulte:

Para saber mais sobre as limitações do tipo de campo, consulte:

If you're using a clustered collection and have the notablescan parameter set to true, your MongoDB Search indexes may not finish building. To resolve this issue, you must set the notablescan parameter to false or check your log for index status transitions.

Para saber mais sobre as limitações do operador de query, consulte:

Para saber mais sobre a compatibilidade e as limitações das opções de query, consulte: