Como indexar campos de data
Nesta página
Você pode utilizar o tipo date
do Atlas Search para indexar valores de data. Você pode fazer query de campos do tipo date
usando os operadores range, near e equals do Atlas Search. Para executar uma query de faceta nos campos date
, você deve indexar os campos de data usando o dateFacet.
Você também pode utilizar o tipo date
para indexar:
Campos cujo valor é uma array de datas. Para saber mais, consulte Como indexar os elementos de uma array.
Campos de data dentro de um array de documentos indexados como o tipo embeddedDocuments.
Campos de data para classificação. O Atlas Search indexa automaticamente todos os campos de data em índices criados após julho 2023 para classificar os resultados do Atlas Search. Você deve reconstruir os índices preexistentes para usar os campos de data do índice para classificação. Para saber mais, consulte Atualizar seu índice existente e Classificar resultados do Atlas Search.
Observação
Se você habilitar mapeamentos dinâmicos, o Atlas Search indexará automaticamente campos do tipo date
. Você pode utilizar o Editor Visual ou o Editor JSON na UI do Atlas para indexar campos como o tipo date
.
Definir o índice para o tipo date
Para definir o índice para o tipo date
, 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 Date. Para saber mais sobre esse tipo, consulte Propriedades do campo.
Clique em Add.
A seguir está a sintaxeJSON para o tipo date
. Substitua a definição de índice padrão pelo seguinte. Para saber mais sobre os campos, consulte Propriedades do campo.
1 { 2 "mappings": { 3 "dynamic": true|false, 4 "fields": { 5 "<field-name>": { 6 "type": "date" 7 } 8 } 9 } 10 }
Configurar propriedades de campo do date
O tipo Atlas Search date
usa o seguinte parâmetro:
Opção | Tipo | necessidade | Descrição |
---|---|---|---|
| string | necessário | Etiqueta legível por humanos que identifica este tipo de campo. O valor deve ser |
Experimente um exemplo para o tipo date
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.
O exemplo de definição de índice abaixo indexa o campo released
como o tipo date
do Atlas Search para oferecer suporte a queries nesse campo usando os operadores do Atlas Search, como próximo, faixa e igual.
Na janela Add Field Mapping, selecione released no menu suspenso Field Name.
Clique no menu suspenso Data Type e selecione Date.
Clique em Add.
Substitua a definição de índice padrão pela seguinte definição de índice.
1 { 2 "mappings": { 3 "dynamic": false, 4 "fields": { 5 "released": { 6 "type": "date" 7 } 8 } 9 } 10 }
O exemplo de definição de índice a seguir indexa o campo released
como os tipos date
e dateFacet
para retornar os seguintes tipos de resultados para suas queries:
Pesquise resultados de queries usando operadores do Atlas Search, como next, equals e range.
Resultados de metadados para queries usando a faceta Atlas Search.
Na janela Add Field Mapping, selecione released no menu suspenso Field Name.
Clique no menu suspenso Data Type e selecione Date.
Clique em Add.
Repita a etapa 1 e selecione DateFacet no menu suspenso Data Type.
Clique em Add.
Substitua a definição de índice padrão pela seguinte definição de índice.
1 { 2 "mappings": { 3 "dynamic": false, 4 "fields": { 5 "released": [ 6 { 7 "type": "date" 8 }, 9 { 10 "type": "dateFacet" 11 } 12 ] 13 } 14 } 15 }