すべてのプロダクト
Search
ドキュメントセンター

Tablestore:PutTimeseriesData

最終更新日:May 27, 2025

時系列テーブルに時系列データを書き込みます。

リクエスト構文

message PutTimeseriesDataRequest {
  required string table_name = 1; // テーブル名
  required TimeseriesRows rows_data = 2; // 書き込む時系列データの行
  optional MetaUpdateMode meta_update_mode = 3; // メタデータ更新モード
  optional int64 supported_table_version = 4; // Tablestore SDK がサポートする時系列テーブルのモデルバージョン番号
}

パラメーター

必須

説明

table_name

string

はい

時系列テーブルの名前。

rows_data

TimeseriesRows

はい

時系列テーブルに書き込む時系列データの行。

meta_update_mode

MetaUpdateMode

いいえ

メタデータの更新モード。

supported_table_version

int64

いいえ

Tablestore SDK がサポートする時系列テーブルのモデルバージョン番号。有効な値:

説明
  • TimeseriesKey で指定されたスキーマは、モデルのバージョン番号によって異なります。

  • supported_table_version パラメーターで指定されたモデルバージョン番号が、操作を実行する時系列テーブルのモデルバージョン番号よりも古い場合、エラーが発生します。

  • 独自の Tablestore SDK を開発する場合は、このパラメーターを 1 に設定することをお勧めします。

レスポンス構文

message PutTimeseriesDataResponse {
  repeated FailedRowInfo failed_rows = 1; // 書き込みに失敗した行の情報
  optional MetaUpdateStatus meta_update_status = 2; // メタデータの更新ステータス
}

パラメーター

説明

failed_rows

FailedRowInfo

書き込みに失敗した行の情報。

meta_update_status

MetaUpdateStatus

メタデータの更新ステータス。

Tablestore SDK の使用

以下の Tablestore SDK を使用して、時系列テーブルに時系列データを書き込むことができます。