全部产品
Search
文档中心

Tablestore:GetTimeseriesData

更新时间:Jun 24, 2025

Membaca data dalam deret waktu.

Sintaks permintaan

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; // tidak digunakan
  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;
}

Parameter

Tipe

Diperlukan

Deskripsi

table_name

string

Ya

Nama tabel deret waktu.

time_series_key

TimeseriesKey

Ya

Pengenal deret waktu.

begin_time

int64

Tidak

Waktu mulai. Nilai parameter ini adalah cap waktu yang menentukan jumlah mikrodetik yang telah berlalu sejak pukul 00:00:00 UTC pada 1 Januari 1970.

end_time

int64

Tidak

Waktu akhir. Nilai parameter ini adalah cap waktu yang menentukan jumlah mikrodetik yang telah berlalu sejak pukul 00:00:00 UTC pada 1 Januari 1970.

specific_time

int64

Tidak

Waktu spesifik. Nilai parameter ini adalah cap waktu yang menentukan jumlah mikrodetik yang telah berlalu sejak pukul 00:00:00 UTC pada 1 Januari 1970.

token

bytes

Tidak

Token yang digunakan untuk membaca sisa data.

limit

int32

Tidak

Jumlah maksimum baris yang ingin Anda kembalikan.

backward

bool

Tidak

Menentukan apakah akan membaca data dalam urutan kronologis terbalik. Secara default, data dibaca dalam urutan kronologis.

fields_to_get

TimeseriesFieldsToGet

Tidak

Kolom data yang ingin Anda baca.

supported_table_version

int64

Tidak

Nomor versi model tabel deret waktu yang didukung oleh Tablestore SDK. Nilai yang valid:

null
  • Skema yang ditentukan oleh TimeseriesKey bervariasi berdasarkan nomor versi model.

  • Jika nomor versi model yang ditentukan oleh parameter supported_table_version lebih awal dari nomor versi model tabel deret waktu tempat Anda ingin melakukan operasi, kesalahan akan terjadi.

  • Jika Anda ingin mengembangkan Tablestore SDK Anda sendiri, kami sarankan Anda mengatur parameter ini ke 1.

Sintaks respons

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

Parameter

Tipe

Deskripsi

rows_data

bytes

Data deret waktu yang dikembalikan.

next_token

bytes

Token yang digunakan untuk membaca sisa data.

Gunakan Tablestore SDK

Anda dapat menggunakan Tablestore SDK berikut untuk menanyakan data dalam deret waktu: