/ /

Como indexar valores numéricos para pesquisa facetda

Nesta página

Revise as limitações numberFacet
Defina o índice para o tipo numberFacet
Configurar propriedades do campo numberFacet
Experimente um exemplo para o tipo de numberFacet

numberFacet agora está obsoleto. Em vez disso,use um número.

Você pode usar o tipo Atlas Search numberFacet para indexar valores numéricos usando o representation especificado para faceta. Você pode indexar números de tipos de BSON int32, int64 e double.

O Atlas Search suporta apenas query de faceta em campo indexados como o tipo numberFacet . Para executar uma pesquisa normal também no mesmo campo, você deve indexar o campo como tipo number também.

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 number para facet. Você deve utilizar mapeamentos estáticos para indexar valores do number para facetamento. Você pode utilizar o Editor Visual ou o Editor JSON na UI do Atlas para indexar campos number como o tipo number.

Revise as limitações `numberFacet`

Aplicam-se as seguintes limitações:

Não é possível indexar decimal128 para faceta.
Não é possível indexar valores numéricos em arrays ou em um documento contido em uma array para facetmento.
Não é possível facetar campos numéricos indexados como parte de um campo embeddedDocuments .

Defina o índice para o tipo `numberFacet`

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

Clique em Refine Your Index para configurar seu índice.
Na seção Field Mappings, clique em Add Field Mapping para abrir a janela Add Field Mapping.
Clique em Customized Configuration.
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.
Clique no menu suspenso Data Type e selecione NumberFacet.
Configure as propriedades do campo para o tipo numberFacet. Para saber mais, consulte Propriedades do campo.
Clique em Add.

O seguinte é a sintaxe JSON para o tipo numberFacet. 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": "numberFacet",
        "representation": "int64|double",
        "indexIntegers": true|false,
        "indexDoubles": true|false
      }
    }
  }
}

Configurar propriedades do campo `numberFacet`

O tipo numberFacet do Atlas Search usa os seguintes parâmetros:

Opção	Tipo	necessidade	Descrição	Default
`type`	string	Obrigatório	O tipo de campo. O valor deve ser `numberFacet`.
`representation`	string	Opcional	O tipo de dados do campo a indexar. Os valores podem ser um dos seguintes tipos de BSON : `int64` - para indexar inteiros grandes sem perda de precisão e para arredondar valores double para inteiros. Não é possível usar esse tipo para indexar valores double grandes. `double` - para indexar valores double grandes sem arredondamento. Para saber mais, consulte exemplo abaixo.	`double`
`indexIntegers`	booleano	Opcional	Indica se deve indexar ou omitir a indexação de valores do tipo `int32` e `int64` . O valor pode ser `true` ou `false`. Ou isso ou `indexDoubles` deve ser `true`.	`true`
`indexDoubles`	booleano	Opcional	Indica se indexar ou omitir valores de tipo de indexação `double` . O valor pode ser `true` ou `false`. Isto ou `indexIntegers` deve ser `true`.	`true`

Experimente um exemplo para o tipo de `numberFacet`

O exemplo de definição de índice abaixo usa a collection 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.

O exemplo de definição de índice a seguir indexa o campo year como o tipo numberFacet do Atlas Search para oferecer suporte a queries nesse campo usando a faceta do Atlas Search.

Na janela Add Field Mapping, selecione year no menu suspenso Field Name.
Clique no menu suspenso Data Type e selecione NumberFacet.
Aceite os valores padrão para o NumberFacet Properties.
Clique em Add.

Substitua a definição de índice padrão pela seguinte definição de índice.

{
  "mappings": {
    "dynamic": false,
    "fields": {
      "year": {
        "type": "numberFacet"
      }
    }
  }
}

O seguinte exemplo de definição de índice indexa o campo year como os tipos numberFacet e number para retornar os seguintes tipos de resultados para suas queries:

Resultados de metadados para queries usando a faceta Atlas Search.
Pesquise resultados de queries usando operadores do Atlas Search, como next, equals e range.

Na janela Add Field Mapping, selecione year no menu suspenso Field Name.
Clique no menu suspenso Data Type e selecione NumberFacet.
Aceite os valores padrão para o NumberFacet Properties.
Clique em Add.
Repita a etapa 1 e selecione Number no menu suspenso Data Type.
Aceite os valores padrão para o Number Properties.
Clique em Add.

Substitua a definição de índice padrão pela seguinte definição de índice.

{
  "mappings": {
    "dynamic": false,
    "fields": {
      "year": [
        {
          "type": "numberFacet"
        },
        {
          "type": "number"
        }
      ]
    }
  }
}

Dica

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

Consulte as páginas a seguir para obter exemplos adicionais de definição de índice:

Voltar

número

ObjectId

Como indexar valores numéricos para pesquisa facetda

Revise as limitações numberFacet

Defina o índice para o tipo numberFacet

Observação

Configurar propriedades do campo numberFacet