Todos os produtos
Search
Central de documentação

Tablestore:ScanTimeseriesData

Última atualização: Jul 03, 2026

Varre dados de séries temporais.

Sintaxe da solicitação

message ScanTimeseriesDataRequest {
  required string table_name = 1;
  optional bytes split_info = 2;
  optional int64 start_time_us = 3;
  optional int64 end_time_us = 4;
  repeated TimeseriesFieldsToGet fields_to_get = 5;
  optional int32 limit = 6;
  optional RowsSerializeType data_serialize_type = 7;
  optional bytes token = 8;
  optional int64 supported_table_version = 9;
}

Nome

Tipo

Obrigatório

Descrição

table_name

string

Sim

Nome da tabela de séries temporais.

split_info

bytes

Não

SplitInfo retornado pela operação SplitTimeseriesScanTask.

start_time_us

int64

Não

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

end_time_us

int64

Não

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

fields_to_get

repeated TimeseriesFieldsToGet

Não

Colunas de dados a serem lidas.

limit

int32

Não

Número máximo de linhas retornadas por chamada. Valor máximo: 5000. Valor padrão: 5000.

data_serialize_type

RowsSerializeType

Não

Tipo de serialização das linhas de dados de séries temporais.

token

bytes

Não

Token usado para ler os dados restantes.

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.

  • Se a versão do modelo especificada no parâmetro supported_table_version for anterior à versão da tabela de séries temporais alvo, ocorrerá um erro.

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

Sintaxe da resposta

message ScanTimeseriesDataResponse {
  optional RowsSerializeType data_serialize_type = 1;
  required bytes data = 2;
  optional bytes next_token = 3;
}

Parâmetro

Tipo

Obrigatório

Descrição

data_serialize_type

RowsSerializeType

Não

Tipo de serialização das linhas de dados de séries temporais.

data

bytes

Sim

Dados de séries temporais retornados.

next_token

bytes

Não

Token usado para ler os dados restantes.