Tablestore SDK for Java は、TimeSeries モデルの時系列テーブルと時系列データに対するさまざまな操作を提供します。
Tablestore TimeSeries モデルは、時系列データの特性に基づいて設計されており、IoT デバイスの監視、デバイスデータの収集、マシンデータの監視などのシナリオに適しています。TimeSeries モデルの詳細については、概要を参照してください。
時系列テーブルに対する操作
Tablestore TimeSeries モデルを使用するには、CreateTimeseriesTable 操作を呼び出して、時系列データを格納するための時系列テーブルを作成する必要があります。詳細については、時系列テーブルの作成を参照してください。
時系列テーブルを作成した後、時系列テーブルを管理できます。次の表に、時系列テーブルで実行できる操作を示します。
操作 | 説明 |
ListTimeseriesTable 操作を呼び出して、インスタンス内の既存のすべての時系列テーブルの名前をクエリできます。 | |
DescribeTimeseriesTable 操作を呼び出して、テーブル内のデータの有効期限 (TTL) など、時系列テーブルに関する情報をクエリできます。 | |
時系列テーブルの履歴データをクリアしたり、データの保存期間を延長したりするには、UpdateTimeseriesTable 操作を呼び出して、時系列テーブル内のデータの TTL を変更します。時系列テーブル内のデータの TTL を変更した後、Tablestore は、保存期間が TTL を超えるデータを時系列テーブルから自動的かつ非同期的にクリアします。 | |
時系列テーブルを使用して時系列データを格納する必要がなくなった場合は、DeleteTimeseriesTable 操作を呼び出して、時系列テーブルを削除できます。 重要 削除した時系列テーブルは復元できません。この操作を実行する際は注意してください。 |
時系列データに対する操作
時系列テーブルを作成した後、PutTimeseriesData 操作を呼び出して、一度に複数の行の時系列データを時系列テーブルに書き込むことができます。詳細については、時系列データの書き込みを参照してください。
時系列データが時系列テーブルに書き込まれた後、次の操作を実行して、時系列テーブル内の時系列の時系列データをクエリできます。
クエリする時系列に関する情報 (メトリック名やデータソースなど) を取得していない場合は、QueryTimeseriesMeta 操作を呼び出して、複数の条件を指定して必要な時系列を取得できます。詳細については、時系列の取得を参照してください。
時系列メタデータのプロパティが要件を満たしていない場合は、時系列メタデータを更新または削除できます。
操作
説明
UpdateTimeseriesMeta 操作を呼び出して、時系列メタデータの複数のプロパティを一度に変更できます。
DeleteTimeseriesMeta 操作を呼び出して、複数の時系列のメタデータを一度に削除できます。
GetTimeseriesData 操作を呼び出して、特定の時系列内で特定の条件を満たす時系列データをクエリできます。詳細については、時系列データのクエリを参照してください。