Coleções de Time Series

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.

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() 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);
database.createCollection("september2021", collOptions);

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");
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.