全部产品
Search
文档中心

Tablestore:ScanTimeseriesData

更新时间:Jul 02, 2025

Memindai data deret waktu.

Sintaks permintaan

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;
}

Nama

Tipe

Diperlukan

Deskripsi

table_name

string

Ya

Nama tabel deret waktu.

split_info

bytes

Tidak

SplitInfo yang dikembalikan oleh operasi SplitTimeseriesScanTask.

start_time_us

int64

Tidak

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

end_time_us

int64

Tidak

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

fields_to_get

repeated TimeseriesFieldsToGet

Tidak

Kolom data yang ingin Anda baca.

limit

int32

Tidak

Jumlah maksimum baris yang akan dikembalikan untuk satu panggilan. Nilai maksimum: 5.000. Nilai default: 5.000.

data_serialize_type

RowsSerializeType

Tidak

Tipe serialisasi untuk baris data deret waktu.

token

bytes

Tidak

Token yang digunakan untuk membaca sisa data.

supported_table_version

int64

Tidak

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

Catatan
  • 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 terjadi.

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

Sintaks respons

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

Parameter

Tipe

Diperlukan

Deskripsi

data_serialize_type

RowsSerializeType

Tidak

Tipe serialisasi untuk baris data deret waktu.

data

bytes

Ya

Data deret waktu yang dikembalikan.

next_token

bytes

Tidak

Token yang digunakan untuk membaca sisa data.