Como indexar campos de data
Nesta página
Você pode usar o tipo date
do Atlas Search para indexar valores de data. Você pode fazer query de campos do tipo date
os operadoresrange, near e equals do Atlas Search. Para executar uma query de facet nos campos date
, você deve indexar os campos de data usando 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 seus resultados. Você deve reconstruir os índices preexistentes para usar os campos de data do índice para classificação. Para mais informações, consulte Atualizar í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 date
tipo
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.
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 sintaxe JSON 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 date
propriedades de campo do
O tipo Atlas Search date
usa o seguinte parâmetro:
Opção | Tipo | necessidade | Descrição |
---|---|---|---|
type | string | necessário | Etiqueta legível por humanos que identifica este tipo de campo. O valor deve ser date . |
Experimente um exemplo para o date
tipo de
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 seguinte exemplo de definição de índice indexa o campo released
como os tipos date
e dateFacet
para retornar os seguintes tipos de resultados para suas queries:
pesquisar resultados para query usando operadores do Atlas Search, como near, 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 }