Todos os produtos
Search
Central de documentação

Tablestore:GetTimeseriesData

Última atualização: Jul 03, 2026

Lê os dados de uma série temporal.

Sintaxe da solicitação

message GetTimeseriesDataRequest {
  required string table_name = 1;
  required TimeseriesKey time_series_key = 2;
  optional int64 begin_time = 3;
  optional int64 end_time = 4;
  optional int64 specific_time = 5; // not used
  optional bytes token = 6; // bytes
  optional int32 limit = 7;
  optional bool backward = 8;
  repeated TimeseriesFieldsToGet fields_to_get = 9;
  optional int64 supported_table_version = 10;
}

Parâmetro

Tipo

Obrigatório

Descrição

table_name

string

Sim

Nome da tabela de séries temporais.

time_series_key

TimeseriesKey

Sim

Identificadores da série temporal.

begin_time

int64

Não

Hora de início. O valor é um timestamp que indica o número de microssegundos decorridos desde 00:00:00 UTC de 1º de janeiro de 1970.

end_time

int64

Não

Hora de término. O valor é um timestamp que indica o número de microssegundos decorridos desde 00:00:00 UTC de 1º de janeiro de 1970.

specific_time

int64

Não

Hora específica. O valor é um timestamp que indica o número de microssegundos decorridos desde 00:00:00 UTC de 1º de janeiro de 1970.

token

bytes

Não

Token usado para ler os dados restantes.

limit

int32

Não

Número máximo de linhas a retornar.

backward

bool

Não

Define se a leitura dos dados ocorre em ordem cronológica inversa. Por padrão, a leitura segue a ordem cronológica normal.

fields_to_get

TimeseriesFieldsToGet

Não

Colunas de dados a serem lidas.

supported_table_version

int64

Não

Versão do modelo da tabela de séries temporais compatível com o SDK do Tablestore. Valores válidos:

Nota
  • O esquema definido por TimeseriesKey varia conforme a versão do modelo.

  • Ocorrerá um erro se a versão do modelo especificada pelo parâmetro supported_table_version for anterior à versão do modelo da tabela de séries temporais alvo da operação.

  • Para desenvolver seu próprio SDK do Tablestore, defina este parâmetro como 1.

Sintaxe da resposta

message GetTimeseriesDataResponse {
  required bytes rows_data = 1;
  optional bytes next_token = 2;
}

Parâmetro

Tipo

Descrição

rows_data

bytes

Dados da série temporal retornados.

next_token

bytes

Token usado para ler os dados restantes.

Uso dos SDKs do Tablestore

Use os seguintes SDKs do Tablestore para consultar dados de uma série temporal: