時系列コレクション

Overview

このガイドでは、MongoDB の時系列コレクションと、MongoDB Kotlin ドライバーでそれらを操作する方法を学習できます。

時系列コレクションは一定期間にわたる測定値のシーケンスを効率的に保存します。 時系列データは、一定時間にわたって収集されたデータ、測定を説明するメタデータ、測定時間で構成されています。

時系列コレクションの作成

時系列コレクションを作成するには、次のパラメータを createCollection() メソッドに渡します。

• 作成する新しいコレクションの名前

• CreateCollectionOptionsオブジェクトにコレクションを作成するための TimeseriesOptions

val database = mongoClient.getDatabase("fall_weather")
val tsOptions = TimeSeriesOptions("temperature")
val collOptions = CreateCollectionOptions().timeSeriesOptions(tsOptions)
database.createCollection("september2021", collOptions)

コレクションが正常に作成されたかどうかを確認するには、"listCollections" コマンドを runCommand() メソッドに送信します。

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
  }
}

時系列コレクションをクエリする

時系列コレクションでクエリを実行するには、データの取得と集計を行うのと同じ規則を使用します。

詳細については、集計ビルダ のガイドをご覧ください。