時系列データのクエリを実行するために GetTimeseriesData を呼び出す - Tablestore

時系列データを読み取ります。

リクエスト構文

message GetTimeseriesDataRequest {
  required string table_name = 1;
  required TimeseriesKey time_series_key = 2;
  optional int64 begin_time = 3;
  optional int64 end_time = 4;
  optional int64 specific_time = 5; // 使用されていません
  optional bytes token = 6; // バイト
  optional int32 limit = 7;
  optional bool backward = 8;
  repeated TimeseriesFieldsToGet fields_to_get = 9;
  optional int64 supported_table_version = 10;
}

パラメーター	型	必須	説明
table_name	string	はい	時系列テーブルの名前。
time_series_key	TimeseriesKey	はい	時系列識別子。
begin_time	int64	いいえ	開始時刻。このパラメーターの値は、1970年1月1日UTC 00:00:00 から経過したマイクロ秒数を指定するタイムスタンプです。
end_time	int64	いいえ	終了時刻。このパラメーターの値は、1970年1月1日UTC 00:00:00 から経過したマイクロ秒数を指定するタイムスタンプです。
specific_time	int64	いいえ	特定の時刻。このパラメーターの値は、1970年1月1日UTC 00:00:00 から経過したマイクロ秒数を指定するタイムスタンプです。
token	bytes	いいえ	残りのデータを読み取るために使用されるトークン。
limit	int32	いいえ	返される行の最大数。
backward	bool	いいえ	データを逆時間順で読み取るかを指定します。デフォルトでは、データは時間順に読み取られます。
fields_to_get	TimeseriesFieldsToGet	いいえ	読み取るデータ列。
supported_table_version	int64	いいえ	Tablestore SDK でサポートされている時系列テーブルのモデルバージョン番号。有効な値: 0: モデルバージョン番号は、プライマリキー列として指定されたカスタム時系列識別子とデータフィールドを含む時系列テーブルをサポートしていません。これはデフォルト値です。 1: モデルバージョン番号は、カスタム時系列識別子とプライマリキー列として指定されたデータフィールドを含む時系列テーブルをサポートしています。説明 TimeseriesKey で指定されるスキーマは、モデルのバージョン番号によって異なります。 supported_table_version パラメーターで指定されたモデルバージョン番号が、操作を実行する時系列テーブルのモデルバージョン番号よりも古い場合、エラーが発生します。独自の Tablestore SDK を開発する場合は、このパラメーターを `1` に設定することをお勧めします。

レスポンス構文

message GetTimeseriesDataResponse {
  required bytes rows_data = 1;
  optional bytes next_token = 2;
}

パラメーター	型	説明
rows_data	bytes	返された時系列データ。
next_token	bytes	残りのデータを読み取るために使用されるトークン。

Tablestore SDK の使用

以下の Tablestore SDK を使用して、時系列データのクエリを実行できます。