時系列データの粒度の設定

現在のバケット パラメータを取得

現在のコレクション値を取得するには、 listCollectionsコマンドを使用します。

db.runCommand( { listCollections: 1 } )

時系列コレクションの場合、出力にはgranularity 、 bucketMaxSpanSeconds 、およびbucketRoundingSecondsパラメータが含まれます（存在する場合）。

{
    cursor: {
       id: <number>,
       ns: 'test.$cmd.listCollections',
       firstBatch: [
         {
            name: <string>,
            type: 'timeseries',
            options: {
               expireAfterSeconds: <number>,
               timeseries: {
                  timeField: <string>,
                  metaField: <string>,
                  granularity: <string>,
                  bucketMaxSpanSeconds: <number>,
                  bucketRoundingSeconds: <number>
               }
            },
            ...
         },
         ...
       ]
    }
 }

「粒度」パラメータを設定する

次の例では、weather24h コレクションの granularity を minutes に設定します。

db.createCollection(
    "weather24h",
    {
       timeseries: {
          timeField: "timestamp",
          metaField: "metadata",
          granularity: "minutes"
       },
       expireAfterSeconds: 86400
    }
)

カスタム バケット パラメーターの使用

MongoDB 6.3 以降では、granularity の代わりに、2 つのカスタムバケットパラメータを使用してバケット境界を手動で設定できます。深夜0時から 4 時間ごとにデータをクエリするなど、固定された時間間隔でデータをクエリすることを想定している場合は、このアプローチを検討してください。これらの期間の間にバケットが重複しないようにすることで、大量のクエリと insert 操作に最適化されます。

カスタム バケット パラメータを使用するには、両方のパラメータを同じ値に設定し、 granularityを設定しないでください。

• bucketMaxSpanSeconds 同じバケット内のタイムスタンプ間の最大時間を設定します。設定可能な値は 1～31536000 です。

• bucketRoundingSeconds は、新しいバケットの開始タイムスタンプを決定する時間間隔を設定します。 ドキュメントに新しいバケットが必要な場合、MongoDB ではドキュメントのタイムスタンプ値がこの間隔で切り捨てられ、バケットの最小時間が設定されます。

気象ステーションの例では、4時間ごとに概要レポートを生成する場合、 "minutes"のgranularityを使用する代わりに、カスタム バケット パラメータを 14400 秒に設定することでバケットを調整できます。

db.createCollection(
   "weather24h",
   {
      timeseries: {
         timeField: "timestamp",
         metaField: "metadata",
         bucketMaxSpanSeconds: 14400,
         bucketRoundingSeconds: 14400
      }
   }
)

2023-03-27T16:24:35Zという時間が設定されたドキュメントが既存バケットに収まらない場合、MongoDB は最小時間が2023-03-27T16:00:00Zで、最大時間が2023-03-27T19:59:59Zの新しいバケットを作成します。

時系列の粒度の変更

collModコマンドを使用して、 timeseries.granularityを短い時間単位から長い時間単位に増やすことができます。

db.runCommand( {
   collMod: "weather24h",
   timeseries: { granularity: "seconds" | "minutes" | "hours" }
} )

granularityの代わりにカスタム バケット パラメータbucketRoundingSecondsとbucketMaxSpanSecondsを使用している場合は、両方のカスタム パラメータをcollModコマンドに含めて、同じ値に設定します。

db.runCommand( {
   collMod: "weather24h",
   timeseries: {
      bucketRoundingSeconds: 86400,
      bucketMaxSpanSeconds: 86400
   }
} )

粒度間隔またはカスタム バケット値を減らすことはできません。