PutTimeseriesData

调用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支持的时序表模型版本号。取值范围如下:

  • 0(默认):不支持包含自定义时间线标识或作为主键的数据字段的时序表。

  • 1:支持包含自定义时间线标识和作为主键的数据字段的时序表。

不同版本之间的TimeseriesKey数据结构有所不同,supported_table_version低于操作的时序表模型版本会返回错误。

响应消息结构

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

名称

类型

描述

failed_rows

FailedRowInfo

失败的行的错误信息。

meta_update_status

MetaUpdateStatus

元数据更新状态。

使用SDK

您可以使用如下语言的SDK写入时序数据。