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

Tablestore Go SDK は、TimeSeries モデルの時系列テーブルと時系列データに対するさまざまな操作を提供します。

説明

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

時系列テーブルに対する操作

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

時系列テーブルを作成した後、時系列テーブルを管理できます。次の表に、時系列テーブルで実行できる操作を示します。

操作	説明
時系列テーブルの名前をクエリする	インスタンス内の既存の時系列テーブルを表示するには、ListTimeseriesTable 操作を呼び出して、インスタンス内のすべての時系列テーブルの名前をクエリします。
時系列テーブルに関する情報をクエリする	時系列テーブルの構成の詳細を表示するには、DescribeTimeseriesTable 操作を呼び出して、データの Time To Live（TTL）などの時系列テーブルに関する情報をクエリします。
時系列テーブルを更新する	時系列テーブルの履歴データをクリアしたり、データの保存期間を延長したりするには、UpdateTimeseriesTable 操作を呼び出して、時系列テーブルのデータの TTL を変更します。時系列テーブルのデータの TTL を変更すると、Tablestore は、時系列テーブルで TTL を超えるデータを自動的かつ非同期的にクリアします。
時系列テーブルを削除する	時系列テーブルを使用して時系列データを格納する必要がなくなった場合は、DeleteTimeseriesTable 操作を呼び出して、時系列テーブルを削除できます。重要時系列テーブルは、削除すると復元できません。この操作を実行する際は注意してください。時系列テーブルを削除すると、時系列テーブル用に作成された分析ストアも自動的に削除されます。

時系列データに対する操作

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

時系列データが時系列テーブルに書き込まれた後、次の操作を実行して、時系列テーブルの時系列の時系列データをクエリできます。

クエリする時系列に関する情報（メトリック名、データソースなど）がわからない場合は、QueryTimeseriesMeta 操作を呼び出して、複数の条件を指定して時系列を取得できます。詳細については、「時系列を取得する」をご参照ください。

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

操作	説明
時系列メタデータを更新する	UpdateTimeseriesMeta 操作を呼び出して、一度に時系列メタデータの複数のプロパティを変更できます。
時系列メタデータを削除する	DeleteTimeseriesMeta 操作を呼び出して、一度に複数の時系列のメタデータを削除できます。

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

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