Menulis beberapa baris data secara bersamaan. Anda dapat memanggil operasi ini untuk menyisipkan, memodifikasi, atau menghapus satu baris data.
Sintaks permintaan
message BulkImportRequest {
required string table_name = 1;
repeated RowInBulkImportRequest rows = 2;
}Parameter | Tipe | Diperlukan | Deskripsi |
table_name | string | Ya | Nama tabel data. |
rows | repeated RowInBulkImportRequest | Ya | Baris data yang ingin Anda kelola. |
Sintaks respons
message BulkImportResponse {
required string table_name = 1;
repeated RowInBulkImportResponse rows = 2;
}Parameter | Tipe | Diperlukan | Deskripsi |
table_name | string | Ya | Nama tabel data. |
rows | repeated RowInBulkImportResponse | Ya | Menunjukkan apakah operasi penulisan berhasil, pesan kesalahan, dan unit kapasitas (CUs) yang dikonsumsi. Untuk informasi lebih lanjut, lihat Throughput baca dan tulis. |
Menggunakan SDK Tablestore
Tablestore SDK for Java: Menulis data secara batch offline
Konsumsi CU
Jika operasi gagal, tidak ada CU yang dikonsumsi.
Jika permintaan habis waktu dan hasilnya tidak terdefinisi, CU mungkin dikonsumsi atau tidak.
Jika terjadi kesalahan internal dan kode status HTTP 5xx dikembalikan, operasi tidak mengonsumsi CU. Jika kesalahan lain terjadi, satu CU dikonsumsi.
Dalam kasus lain, RowInBulkImportRequest menentukan operasi sisip, pembaruan, dan penghapusan, dan CU yang dikonsumsi dihitung secara independen berdasarkan operasi yang dilakukan. Berikut adalah metode perhitungan CU yang dikonsumsi saat melakukan operasi sisip, pembaruan, dan penghapusan pada baris data.
Saat menyisipkan satu baris data, jumlah CU tulis yang dikonsumsi dibulatkan ke atas dari nilai yang dihitung berdasarkan rumus berikut: (Ukuran data di semua kolom kunci utama baris + Ukuran data di kolom atribut yang disisipkan)/4 KB.
Saat memperbarui satu baris data, jumlah CU tulis yang dikonsumsi dibulatkan ke atas dari nilai yang dihitung berdasarkan rumus berikut: (Ukuran data di semua kolom kunci utama baris + Ukuran data di kolom atribut yang diperbarui)/4 KB. Jika ingin menghapus kolom atribut saat memperbarui satu baris data, hanya panjang nama kolom yang termasuk dalam ukuran data kolom atribut.
Saat menghapus satu baris data, jumlah CU tulis yang dikonsumsi dibulatkan ke atas dari nilai yang dihitung berdasarkan rumus berikut: Ukuran data di semua kolom kunci utama baris/4 KB.
Untuk informasi lebih lanjut tentang cara menghitung ukuran data, lihat Penggunaan Penyimpanan.