Menu Docs
Página inicial do Docs
/ /

Criar e consultar uma coleção de séries temporais

Esta página mostra como criar e consultar uma coleção de séries temporais. Os exemplos de código fornecidos criam e funcionam com dados meteorológicos de amostra que contêm tempo, temperatura e informações do sensor.

Importante

Requisitos da versão de compatibilidade de recursos

Você só pode criar coleções de séries temporais em um sistema com featureCompatibilityVersion definido como 5.0 ou superior.

Uma coleção de séries temporais inclui os seguintes campos:

Campo
Tipo
Descrição

timeseries.timeField

string

Obrigatório. O nome do campo que contém a data em cada documento da série temporal. Os documentos em uma collection de séries temporais devem ter uma data BSON válida como o valor do timeField.

timeseries.metaField

string

Opcional. O nome do campo que contém metadados em cada documento de série temporal. Os metadados no campo especificado devem ser dados utilizados para rotular uma série exclusiva de documentos. Os metadados raramente devem mudar. O nome do campo especificado não pode ser _id ou o mesmo que o timeseries.timeField. O campo pode ser de qualquer tipo de dados.

Embora o campo metaField seja opcional, o uso de metadados pode melhorar a otimização da query. Por exemplo, o MongoDB cria automaticamente um índice composto nos campos metaField e timeField para novas collections. Se você não fornecer um valor para este campo, os dados serão agrupados exclusivamente com base no tempo.

timeseries.granularity

inteiro

Opcional. Não use se estiver configurando bucketRoundingSeconds e bucketMaxSpanSeconds.

Os valores possíveis são seconds (padrão), minutes e hours.

Defina granularity como o valor que mais se aproxima do tempo entre carimbos de data/hora consecutivos de entrada. Isso melhora o desempenho otimizando a forma como o MongoDB armazena dados na collection.

Para obter mais informações sobre granularidade e intervalos de bucket, consulte Definir granularidade para dados de séries temporais.

timeseries.bucketMaxSpanSeconds

inteiro

Opcional. Use com bucketRoundingSeconds como alternativa a granularity. Define o tempo máximo entre os carimbos de data/hora no mesmo bloco.

Os valores possíveis são 1-31536000.

Novidades na versão 6.3.

timeseries.bucketRoundingSeconds

inteiro

Opcional. Use com bucketMaxSpanSeconds como alternativa a granularity. Deve ser igual a bucketMaxSpanSeconds.

Quando um documento requer um novo bucket, o MongoDB arredonda para baixo o valor de carimbo de data/hora do documento por esse intervalo para definir o tempo mínimo para o bucket.

Novidades na versão 6.3.

expireAfterSeconds

inteiro

Opcional. Ative a exclusão automática de documentos em uma coleção de séries temporais especificando o número de segundos após os quais os documentos expiram. O MongoDB exclui documentos expirados automaticamente. Consulte Configurar remoção automática para Coleções de séries temporais (TTL) para obter mais informações.

Outras opções permitidas que não são específicas para coleções de séries temporais são:

  • storageEngine

  • indexOptionDefaults

  • collation

  • writeConcern

  • comment

Voltar

Criar e configurar

Nesta página