Coleções de Time Series
Nesta página
Visão geral
Neste guia, você aprenderá sobre coleções de séries temporais no MongoDB e como interagir com elas no driver Java do MongoDB.
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 createCollection() método:
O nome da nova collection a ser criada
As opções TimeSeries para criar a coleção em um CreateCollectionOptions objeto
MongoDatabase database = mongoClient.getDatabase("fall_weather"); TimeSeriesOptions tsOptions = new TimeSeriesOptions("temperature"); CreateCollectionOptions collOptions = new CreateCollectionOptions().timeSeriesOptions(tsOptions); // Creates a time series collection that stores "temperature" values over time 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.
Document commandResult = database.runCommand(new Document("listCollections", new BsonInt64(1))); List<String> keys = Arrays.asList("cursor"); // Prints information about the database's collections and views System.out.println("listCollections: " + commandResult.getEmbedded(keys, Document.class).toJson());
Seu resultado deve ser semelhante ao seguinte:
{ "id": <some number>, "ns": "<db name>.$cmd.listCollections", "firstBatch": [ { "name": "<time series collection name>", "type": "timeseries", "options": { "expireAfterSeconds": <some number>, "timeseries": { ... } }, ... }, ... ] }
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 agregação pipeline. Você pode usar funções de janela para executar operações em uma extensão contígua de dados de séries temporais. Para obter mais informações, consulte nosso guia de construtores de agregados.