時系列データのスキャン - Tablestore - Alibaba Cloud ドキュメントセンター

時系列データをスキャンします。

リクエスト構文

message ScanTimeseriesDataRequest {
  required string table_name = 1; // 時系列テーブルの名前
  optional bytes split_info = 2; // SplitTimeseriesScanTask 操作から返された SplitInfo
  optional int64 start_time_us = 3; // 開始時刻。1970年1月1日UTC 00:00:00からの経過マイクロ秒数
  optional int64 end_time_us = 4; // 終了時刻。1970年1月1日UTC 00:00:00からの経過マイクロ秒数
  repeated TimeseriesFieldsToGet fields_to_get = 5; // 読み取るデータ列
  optional int32 limit = 6; // 1回の呼び出しで返す最大行数。最大値：5000。デフォルト値：5000
  optional RowsSerializeType data_serialize_type = 7; // 時系列データの行のシリアル化タイプ
  optional bytes token = 8; // 残りのデータを読み取るために使用するトークン
  optional int64 supported_table_version = 9; // Tablestore SDK がサポートする時系列テーブルのモデルバージョン番号。有効な値：
}

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

レスポンス構文

message ScanTimeseriesDataResponse {
  optional RowsSerializeType data_serialize_type = 1; // 時系列データの行のシリアル化タイプ
  required bytes data = 2; // 返された時系列データ
  optional bytes next_token = 3; // 残りのデータを読み取るために使用するトークン
}

パラメーター	型	必須	説明
data_serialize_type	RowsSerializeType	いいえ	時系列データの行のシリアル化タイプ。
data	bytes	はい	返された時系列データ。
next_token	bytes	いいえ	残りのデータを読み取るために使用するトークン。