Menu Docs
Página inicial do Docs
/
MongoDB Atlas
/ / / /

Como indexar campos de strings para pesquisa de facet

Nesta página

  • Definir o índice para o tipo stringFacet
  • Configurar propriedades para o tipo stringFacet
  • Experimente um exemplo para o tipo de stringFacet

Você pode usar o tipo de Atlas Search stringFacet para indexar campos destring para faceting, o que permite que você execute uma consulta de faceta nesse campo. O Atlas Search não aplica o analisador ao indexar campos string para facetagem.

O Atlas Search tem suporte somente para queries de facetas em campos indexados como o tipo stringFacet. Para também fazer uma pesquisa normal no mesmo campo, você também deve indexar o campo como tipo string.

Para faceta em campos de string em documentos incorporados, você deve indexar os campos principais como o tipo de documento. Quando facetas são utilizadas em um campo de string dentro de documentos incorporados, o Atlas Search retorna a contagem de facetas somente para o número de documentos principais correspondentes.

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

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.

  1. Clique em Refine Your Index para configurar seu índice.

  2. Na seção Field Mappings, clique em Add Field Mapping para abrir a janela Add Field Mapping.

  3. Clique em Customized Configuration.

  4. Selecione o campo a ser indexado no menu suspenso Field Name.

    Observação

    Você não pode indexar campos que contêm o sinal de dólar ($) no início do nome do campo.

  5. Clique no menu suspenso Data Type e selecione StringFacet. Para saber mais sobre esse tipo, consulte Propriedades do campo.

  6. Clique em Add.

A seguir está a sintaxeJSON para o tipo stringFacet. Substitua a definição de índice padrão pelo seguinte. Para saber mais sobre os campos, consulte Propriedades do campo.

{
"mappings": {
"dynamic": true|false,
"fields": {
"<field-name>": {
"type": "stringFacet"
}
}
}
}

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

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

Data Type

type

string

Obrigatório

Etiqueta legível para humanos que identifica este tipo de campo. O valor deve ser stringFacet. O Atlas Search trunca os valores BSON string indexados como o tipo stringFacet para cerca de 8000 unidades de código UTF-16.

O exemplo de definição de índice abaixo usa a coleção sample_mflix.movies. Se você já tiver os dados de amostra carregados em seu cluster, poderá usar o Visual Editor ou o Editor JSON na UI do Atlas para configurar o índice. Após selecionar seu método de configuração preferido, selecione o banco de dados e a coleção e filtre seu índice para adicionar mapeamentos de campo.

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

  1. Na janela Add Field Mapping, selecione genres no menu suspenso Field Name.

  2. Clique no menu suspenso Data Type e selecione StringFacet.

  3. Clique em Add.

{
"mappings": {
"dynamic": false,
"fields": {
"genres": {
"type": "stringFacet"
}
}
}
}

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:

  • Resultados de metadados para queries usando a faceta Atlas Search.

  • Pesquise resultados para queries usando operadores do Atlas Search como texto, frase e outros operadores que executam pesquisa de texto.

  1. Na janela Add Field Mapping, selecione genres no menu suspenso Field Name.

  2. Clique no menu suspenso Data Type e selecione StringFacet.

  3. Clique em Add.

  4. Repita a etapa 1 e selecione String no menu suspenso Data Type.

  5. Revise a configuração padrão do String Properties e clique em Add.

{
"mappings": {
"dynamic": false,
"fields": {
"genres": [
{
"type": "stringFacet"
},
{
"type": "string"
}
]
}
}
}

Dica

Consulte também: Exemplos adicionais de definição de índice

Voltar

string