Coleções de Time Series
Nesta página
Visão geral
Neste guia, você pode aprender sobre coleção de séries temporais no MongoDB e como interagir com elas no driver MongoDB Kotlin.
As coleções de séries temporais armazenam eficientemente sequências de medições durante um período de tempo. Os dados de série temporal consistem em quaisquer dados coletados ao longo do tempo, metadados que descrevem a medição e o tempo da medição.
Exemplo | Medição | Metadata |
---|---|---|
Dados de vendas | receita | Empresa |
Taxas de infecção | Quantidade de pessoas infectadas | Localização |
Crie uma coleção de séries temporais
Para criar uma coleção de séries temporais, passe os seguintes parâmetros para o método createCollection():
O nome da nova collection a ser criada
As opções TimeSeries para criar a coleção em um CreateCollectionOptions objeto
val database = mongoClient.getDatabase("fall_weather") val tsOptions = TimeSeriesOptions("temperature") val collOptions = CreateCollectionOptions().timeSeriesOptions(tsOptions) database.createCollection("september2021", collOptions)
Importante
Versões anteriores ao MongoDB 5.0 não podem criar uma coleção de séries temporais.
Para verificar se você criou a coleção com sucesso, envie o "listCollections"
comando para o comando runCommand() método.
val commandResult = database.listCollections().toList() .find { it["name"] == "september2021" } println(commandResult?.toJson(JsonWriterSettings.builder().indent(true).build()))
{ "name": "september2021", "type": "timeseries", "options": { "timeseries": { "timeField": "temperature", "granularity": "seconds", "bucketMaxSpanSeconds": 3600 } }, "info": { "readOnly": false } }
Consultar uma Coleta de Seqüência Temporal
Para fazer query em uma coleção de séries temporais, use as mesmas convenções que usaria para recuperar e agregar dados.
Observação
Funções de janela
A versão 5.0 do MongoDB introduz funções de janela no aggregation pipeline. Você pode usar funções de janela para executar operações em uma extensão contígua de dados de time-series.
Para obter mais informações, consulte nosso guia Construtores de agregados.