全部產品
Search
文件中心

Tablestore:PutTimeseriesData

更新時間:May 27, 2025

調用PutTimeseriesData介面寫入時序資料。

請求訊息結構

message PutTimeseriesDataRequest {
  required string table_name = 1;
  required TimeseriesRows rows_data = 2;
  optional MetaUpdateMode meta_update_mode = 3;
  optional int64 supported_table_version = 4;
}

名稱

類型

是否必選

描述

table_name

string

時序表名稱。

rows_data

TimeseriesRows

多行時序資料。

meta_update_mode

MetaUpdateMode

中繼資料更新模式。

supported_table_version

int64

SDK中支援的時序表模型版本號碼。取值範圍如下:

說明
  • 不同版本號碼會導致TimeseriesKey資料結構的差異。

  • 如果SDK中的版本號碼低於待操作的時序表模型版本號碼,將會導致錯誤。

  • 如果您需自行開發Tablestore SDK,建議將其取值設定為固定值1

響應訊息結構

message PutTimeseriesDataResponse {
  repeated FailedRowInfo failed_rows = 1;
  optional MetaUpdateStatus meta_update_status = 2;
}

名稱

類型

描述

failed_rows

FailedRowInfo

失敗的行的錯誤資訊。

meta_update_status

MetaUpdateStatus

中繼資料更新狀態。

使用SDK

您可以使用如下語言的SDK寫入時序資料。