全部产品
Search
文档中心

Tablestore:BulkImport

更新时间:Jul 02, 2025

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.