時系列データ

項目一覧

Overview

時系列コレクションの作成
時系列データの保存
時系列データのクエリ
詳細情報

Overview

このガイドでは、 Cドライバーを使用して 時系列データ を保存し、操作する方法を学習できます。

時系列データは、次のコンポーネントで構成されています。

測定値
測定のタイムスタンプ
測定を説明するメタデータ

次の表では、時系列データを保存できるサンプル状況について説明します。

状況	測定値	Metadata
業種別の月間売上の記録	USD 建てでの収益	会社、国
気象変化の追跡	降量レベル	ロケーション、センサータイプ
家一軒の価格の変動を記録する	月額料金	ロケーション、通貨

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

重要

時系列コレクション用のサーバーバージョン

時系列コレクションを作成して操作するには、MongoDB Server 5.0以降を実行している配置に接続する必要があります。

時系列データを保存するには、時系列コレクションを作成します。時系列コレクションを作成するには、次のパラメータを mongoc_database_create_collection() 関数に渡します。

コレクションを作成するデータベース
作成する新しいコレクションの名前
timeField オプションを指定する timeseriesオブジェクト

次の例では、fall_weatherデータベースに timeField オプションを "timestamp" フィールドに設定して、october2024 という名前の時系列コレクションを作成します。

// Initialize the MongoDB C Driver
mongoc_init ();
// Create a new client instance
mongoc_client_t *client = mongoc_client_new ("<connection string>");
// Get a handle on the database
mongoc_database_t *database = mongoc_client_get_database (client, "fall_weather");
// Create options for the time series collection
bson_t *opts = BCON_NEW (
    "timeseries", "{",
    "timeField", BCON_UTF8 ("timestamp"),
    "}");
// Create the time series collection
bson_error_t error;
mongoc_collection_t *collection = mongoc_database_create_collection (database, "october2024", opts, &error);
if (!collection) {
    fprintf(stderr, "Error creating collection: %s\n", error.message);
}
bson_destroy (opts);

時系列コレクションが正常に作成されたことを確認するには、fall_weatherデータベースで mongoc_database_find_collections_with_opts() 関数を実行し、結果を出力します。

// List collections in the database
mongoc_cursor_t *cursor = mongoc_database_find_collections_with_opts (database, NULL);
const bson_t *doc;
while (mongoc_cursor_next (cursor, &doc))
{
    char *str = bson_as_canonical_extended_json (doc, NULL);
    printf ("%s\n", str);
    bson_free (str);
}
// Check for cursor errors
if (mongoc_cursor_error (cursor, &error))
{
    fprintf (stderr, "Cursor error: %s\n", error.message);
}
mongoc_cursor_destroy (cursor);

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