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.
See how MongoDB 9.0 delivers up to 2x higher throughput.
MongoDB Branding Shape
Register now >
Menu Docs

Como indexar campos de strings para pesquisa de facet

Você pode usar o tipo stringFacet do MongoDB Search para indexar campos de string para facet, o que permite executar uma query de operador de faceta nesse campo. O MongoDB Search não aplica o analisador ao indexar campos string para facet.

O MongoDB Search suporta apenas queries de operadores de faceta em campos indexados como o tipo stringFacet . Para executar uma pesquisa normal também no mesmo campo, você também deve indexar o campo como tipo string.

Para faceta campos de string em documentos incorporados, você deve indexar os campos pai como o tipo de documento. Quando você faceta um campo de string dentro de documentos incorporados, o MongoDB Search retorna a contagem de faceta apenas para o número de documentos pai correspondentes.

O MongoDB Search não indexa dinamicamente valores string para facetamento. Você deve usar mapeamentos estáticos para indexar valores string para facet. Você pode utilizar o Editor Visual ou o Editor JSON na UI do Atlas para indexar campos string como o tipo number.

Para definir o índice para o tipo stringFacet , escolha seu método de configuração preferido na UI do Atlas e então selecione o banco de dados e collection.

O tipo MongoDB Search stringFacet tem os seguintes parâmetros:

Nome do campo UI
JSON Option
Tipo
necessidade
Descrição
Data Type

type

string

Obrigatório

Human-readable label that identifies this field type. Value must be stringFacet. MongoDB Search truncates BSON string values indexed as the stringFacet type to around 8000 UTF-16 code units.

The following index definition example uses the sample_mflix.movies collection. If you have the sample data already loaded on your cluster, you can use the Visual Editor or JSON Editor in the Atlas UI to configure the index. After you select your preferred configuration method, select the database and collection, and refine your index to add field mappings.

A seguinte definição de índice para a coleção sample_mflix.movies no conjunto de dados de amostra indexa o campo genres como stringFacet para faceting.

A seguinte definição de índice para a coleção sample_mflix.movies no conjunto de dados de amostra indexa o campo genres como tipos stringFacet e string para retornar os seguintes tipos de resultados para suas queries:

Para aprender mais sobre o coletor facet e ver exemplos de queries, consulte Exemplos.

Para saber como criar um índice com uma definição de faceta e consultar esse índice usando o coletor facet, consulte o tutorial Como usar facets com o MongoDB Search.

Para ver um exemplo de índice e consulta que usa stringFacet para executar uma pesquisa facetada com resultados paginados, consulte Usar faceta com os resultados paginados.