Gunakan API BulkExport untuk Ekspor Dataset Besar Secara Efisien - Tablestore

Mengekspor data secara batch.

Sintaks permintaan

message BulkExportRequest {
    required string table_name = 1;
    repeated string columns_to_get = 2;
    required bytes inclusive_start_primary_key = 3;
    required bytes exclusive_end_primary_key = 4;
    optional bytes filter = 5;
    optional DataBlockType data_block_type_hint = 6 [default = DBT_SIMPLE_ROW_MATRIX];
}

Parameter	Tipe	Diperlukan	Deskripsi
table_name	string	Ya	Nama tabel data.
columns_to_get	string	Tidak	Kolom yang ingin Anda ekspor. Jika parameter ini tidak ditentukan, semua kolom akan diekspor.
inclusive_start_primary_key	bytes	Ya	Kunci primer awal yang dikodekan dalam format PlainBuffer. Untuk informasi lebih lanjut, lihat PlainBuffer. Jika baris ada, baris tersebut termasuk dalam respons.
exclusive_end_primary_key	bytes	Ya	Kunci primer akhir yang dikodekan dalam format PlainBuffer. Untuk informasi lebih lanjut, lihat PlainBuffer. Baris tidak termasuk dalam respons terlepas dari apakah baris tersebut ada.
filter	bytes	Tidak	Kondisi filter yang dikodekan dalam format PlainBuffer. Untuk informasi lebih lanjut, lihat PlainBuffer.
data_block_type_hint	DataBlockType	Tidak	Tipe blok data dari hasil yang dikembalikan.

Sintaks respons

message BulkExportResponse {
     required ConsumedCapacity consumed = 1;
     required bytes rows = 2;
     optional bytes next_start_primary_key = 3;
     optional DataBlockType data_block_type = 4;
}

Parameter	Tipe	Diperlukan	Deskripsi
consumed	ConsumedCapacity	Ya	Jumlah unit kapasitas (CUs) yang dikonsumsi oleh operasi. Untuk informasi lebih lanjut, lihat Konsumsi CU.
rows	bytes	Ya	Data baris yang diekspor, termasuk kunci primer dan kolom atribut. Data baris dikodekan dalam format PlainBuffer. Untuk informasi lebih lanjut, lihat PlainBuffer.
next_start_primary_key	bytes	Tidak	Kunci primer awal untuk operasi baca berikutnya. Kunci primer awal dikodekan dalam format PlainBuffer. Untuk informasi lebih lanjut, lihat PlainBuffer. Jika nilai yang dikembalikan kosong, semua data telah dibaca.
data_block_type	DataBlockType	Tidak	Tipe blok data dari hasil yang dikembalikan.

Menggunakan SDK Tablestore

Tablestore SDK for Java: Membaca Data Offline Secara Batch

Konsumsi CU:

Jika baris yang diminta tidak ada, satu pembacaan CU akan dikonsumsi.
Jika baris yang diminta ada, jumlah CU baca yang dikonsumsi dihitung berdasarkan rumus berikut dan dibulatkan ke atas: Jumlah CU baca yang dikonsumsi = (Ukuran data di semua kolom kunci primer baris + Ukuran data di kolom atribut yang dibaca)/4 KB. Untuk informasi lebih lanjut tentang cara menghitung ukuran data, lihat Penggunaan Penyimpanan.
Jika permintaan habis waktu dan hasilnya tidak terdefinisi, CU mungkin dikonsumsi atau tidak.
Jika kode status HTTP 5xx dikembalikan, yang menunjukkan bahwa kesalahan internal terjadi, operasi tidak mengonsumsi CU. Jika kesalahan lain dikembalikan, satu CU baca dikonsumsi.