All Products
Search
Document Center

Tablestore:PutTimeseriesData

Last Updated:May 26, 2025

Writes time series data to a time series table.

Request syntax

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

Parameter

Type

Required

Description

table_name

string

Yes

The name of the time series table.

rows_data

TimeseriesRows

Yes

The rows of time series data that you want to write to the time series table.

meta_update_mode

MetaUpdateMode

No

The metadata update mode.

supported_table_version

int64

No

The model version number of the time series table supported by the Tablestore SDK. Valid values:

Note
  • The schema specified by TimeseriesKey varies based on the model version number.

  • If the model version number specified by the supported_table_version parameter is earlier than the model version number of the time series table on which you want to perform operations, an error occurs.

  • If you want to develop your own Tablestore SDK, we recommend that you set this parameter to 1.

Response syntax

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

Parameter

Type

Description

failed_rows

FailedRowInfo

The information about the rows that fail to be written.

meta_update_status

MetaUpdateStatus

The metadata update status.

Use Tablestore SDKs

You can use the following Tablestore SDKs to write time series data to a time series table: