Tablestore SDK for Go を使用した時系列モデルの使用 - Tablestore

Tablestore SDK for Go は、時系列モデルの時系列テーブル、時系列データ、に対してさまざまなオペレーションを提供します。

説明

Tablestore の時系列モデルは、時系列データの特性に基づいて設計されており、IoT デバイスの監視、デバイスデータの収集、マシンデータの監視などのシナリオに適しています。時系列モデルの詳細については、「Overview」をご参照ください。

時系列テーブルに対するオペレーション

Tablestore の時系列モデルを使用するには、CreateTimeseriesTable API を呼び出して、時系列データを格納するための時系列テーブルを作成する必要があります。詳細については、「Create a time series table」をご参照ください。

時系列テーブルを作成した後は、時系列テーブルを管理できます。次の表に、時系列テーブルに対して実行できるオペレーションを示します。

オペレーション	説明
時系列テーブル名のクエリ	インスタンス内の既存の時系列テーブルを確認するには、ListTimeseriesTable API を呼び出して、インスタンス内のすべての時系列テーブル名をクエリします。
時系列テーブル情報のクエリ	時系列テーブルの構成の詳細を確認するには、DescribeTimeseriesTable API を呼び出して、データの生存時間 (TTL) など、時系列テーブルに関する情報をクエリします。
時系列テーブルの更新	時系列テーブル内の履歴データをクリアする、またはデータの保持期間を延長するには、UpdateTimeseriesTable API を呼び出して、時系列テーブル内データの TTL を変更します。時系列テーブル内データの TTL を変更すると、Tablestore は時系列テーブル内で TTL を超過したデータを自動的かつ非同期にクリアします。
Go SDK を使用した時系列テーブルの削除	時系列データを格納するために時系列テーブルが不要になった場合は、DeleteTimeseriesTable API を呼び出して時系列テーブルを削除できます。重要時系列テーブルは削除後に復元できません。このオペレーションは注意して実行してください。時系列テーブルを削除すると、システムはその時系列テーブルの分析ストアを自動的に削除します。

時系列テーブルを作成した後、PutTimeseriesData API を呼び出して、複数行の時系列データを一度に時系列テーブルへ書き込むことができます。詳細については、「Write time series data」をご参照ください。

時系列データを時系列テーブルに書き込んだ後、テーブル内の特定の時系列について、次のオペレーションでそのデータをクエリできます。

クエリする時系列のメトリクス名やデータソースなどの情報が不明な場合は、QueryTimeseriesMeta API を呼び出し、複数条件を指定して時系列を取得できます。詳細については、「Retrieve time series」をご参照ください。

時系列メタデータのプロパティが要件を満たさない場合は、時系列メタデータを更新または削除できます。

オペレーション	説明
時系列メタデータの更新	UpdateTimeseriesMeta API を呼び出して、時系列メタデータ内の複数のプロパティを一度に変更できます。
時系列メタデータの削除	DeleteTimeseriesMeta API を呼び出して、複数の時系列のメタデータを一度に削除できます。

GetTimeseriesData API を呼び出して、特定の時系列において特定の条件を満たす時系列データをクエリできます。詳細については、「Query time series data」をご参照ください。

時系列データを時系列テーブルに書き込んだ後、分析ストアを使用して特定の時系列のデータをクエリおよび分析する場合は、分析ストア用のマッピングテーブルを作成し、SELECT 文を実行して時系列データをクエリできます。詳細については、「SQL query examples」をご参照ください。