Dados de Time Series

Visão geral

Neste guia, você pode aprender como usar o driver Kotlin Sync para armazenar e interagir com dados de séries temporais.

Os dados de série temporal são compostos pelos seguintes componentes:

• Quantidade medida

• Carimbo de data/hora para a medição

• Metadados que descrevem a medição

A tabela a seguir descreve situações de exemplo para as quais você pode armazenar dados de série temporal:

Crie uma coleção de séries temporais

Você pode criar uma coleção de séries temporais para armazenar dados 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

• Uma CreateCollectionOptions objeto com as TimeSeriesOptions definir usando o timeSeriesOptions() método

val database = mongoClient.getDatabase("fall_weather")
val tsOptions = TimeSeriesOptions("timestamp")
val collectionOptions = CreateCollectionOptions().timeSeriesOptions(tsOptions)
database.createCollection("october2024", collectionOptions)

val results = database.listCollections()
val jsonSettings = JsonWriterSettings.builder().indent(true).build()
results.forEach { result ->
    println(result.toJson(jsonSettings))
}

 {
   "name": "october2024",
   "type": "timeseries",
   "options": {
     "timeseries": {
       "timeField": "temperature",
       "granularity": "seconds",
       "bucketMaxSpanSeconds": 3600
     }
   },
   "info": {
     "readOnly": false
   }
}
...

Armazenar dados de série temporal

Você pode inserir dados em uma coleção de séries temporais usando os métodos insertOne() ou insertMany() e especificando a medida, o carimbo de data/hora e os metadados em cada documento inserido.

val collection = database.getCollection<Document>("october2024")
// Temperature data for October 1, 2024
val temperature1 = Document("temperature", 54)
                    .append("location", "New York City")
                    .append("timestamp", Date(1727755200000))
// Temperature data for October 2, 2024
val temperature2 = Document("temperature", 55)
                    .append("location", "New York City")
                    .append("timestamp", Date(1727841600000))
collection.insertMany(listOf(temperature1, temperature2))

Consultar dados de série temporal

Você pode usar a mesma sintaxe e convenções para consultar os dados armazenados em uma coleção de séries temporais que você usa ao executar operações de leitura ou agregação em outras collections. Para saber mais sobre essas operações, consulte a seção Informações adicionais .

Informações adicionais

Para saber mais sobre os conceitos mencionados neste guia, consulte as seguintes entradas de manual do MongoDB Server :

• Séries temporais

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

• Definir granularidade para dados de série temporal

Para saber mais sobre como realizar operações de leitura, consulte Ler dados do MongoDB.

Para saber mais sobre como realizar operações de agregação , consulte o guia Transforme seus dados com agregação .