Tablestore menyediakan operasi DeleteRow untuk menghapus satu baris data dan operasi BatchWriteRow untuk menghapus beberapa baris data sekaligus.
Catatan penggunaan
Data yang dihapus tidak dapat dipulihkan. Lanjutkan dengan hati-hati.
Prasyarat
Sebuah instance OTSClient telah diinisialisasi. Untuk informasi lebih lanjut, lihat Inisialisasi Instance OTSClient.
Tabel data telah dibuat dan data telah ditulis ke tabel tersebut. Untuk informasi lebih lanjut, lihat Create a Data Table dan Write Data.
Hapus satu baris data
Anda dapat memanggil operasi DeleteRow untuk menghapus satu baris data. Jika baris yang ingin dihapus tidak ada, tabel data tetap tidak berubah.
Operasi API
/**
* Hapus satu baris data.
*/
deleteRow(params, callback) Parameter
Parameter | Diperlukan | Deskripsi |
tableName | Ya | Nama tabel data. |
primaryKey | Ya | Kunci utama dari baris. Nilai parameter ini terdiri dari nama, tipe, dan nilai setiap kolom kunci utama. Penting Jumlah dan tipe kolom kunci utama yang Anda tentukan harus sama dengan jumlah dan tipe kolom kunci utama sebenarnya dalam tabel. |
condition | Ya | Kondisi yang harus dipenuhi untuk melakukan operasi. Anda dapat menentukan kondisi keberadaan baris atau kondisi berdasarkan nilai kolom. Untuk informasi lebih lanjut, lihat Konfigurasi pembaruan bersyarat. |
Contoh kode
Berikut adalah contoh kode untuk menghapus baris dari tabel data:
var TableStore = require('../index.js');
var Long = TableStore.Long;
var client = require('./client');
var params = {
tableName: "sampleTable",
condition: new TableStore.Condition(TableStore.RowExistenceExpectation.IGNORE, null),
primaryKey: [{ 'gid': Long.fromNumber(8) }, { 'uid': Long.fromNumber(80) }]
};
client.deleteRow(params, function (err, data) {
if (err) {
console.log('error:', err);
return;
}
console.log('success:', data);
});
Untuk melihat contoh kode lengkapnya, kunjungi DeleteRow@GitHub.
Hapus beberapa baris data sekaligus
Pilih metode yang sesuai berdasarkan kebutuhan bisnis Anda untuk menanyakan informasi kunci utama tentang data yang ingin dihapus.
Untuk menghapus data yang nilai kunci utamanya berada dalam rentang tertentu, panggil operasi GetRange untuk menanyakan data dan mendapatkan informasi kunci utama tentang data tersebut. Untuk informasi lebih lanjut, lihat Baca Data yang Nilai Kunci Utamanya Berada dalam Rentang Tertentu.
Untuk menghapus data yang memenuhi kondisi tertentu dari tabel data tempat indeks pencarian dibuat, gunakan indeks pencarian untuk menanyakan data dan mendapatkan informasi kunci utama tentang data tersebut. Untuk informasi lebih lanjut, lihat Kueri Dasar.
Untuk menghapus semua data dari tabel data, kami sarankan Anda menghapus tabel data dan membuat tabel data baru dengan konfigurasi yang sama.
Anda juga dapat memanggil operasi GetRange dan atur kunci utama awal ke INF_MIN serta kunci utama akhir ke INF_MAX untuk memindai semua data dalam tabel. Dengan cara ini, Anda bisa mendapatkan informasi kunci utama tentang semua data dalam tabel. Namun, ini mengonsumsi banyak sumber daya komputasi. Lanjutkan dengan hati-hati.
Panggil operasi BatchWriteRow untuk menghapus beberapa baris data sekaligus berdasarkan informasi kunci utama tentang baris-baris tersebut. Untuk informasi lebih lanjut, lihat Tulis Beberapa Baris Data Sekaligus.
Referensi
Time to live (TTL) menentukan periode retensi data. Anda dapat mengonfigurasi TTL untuk tabel data agar data yang kedaluwarsa dihapus secara otomatis. Untuk informasi lebih lanjut, lihat Versi Data dan TTL.