Penghapusan
Dokumen ini menjelaskan cara menghapus data yang disimpan dalam tabel Bigtable, membahas kapan Anda harus menggunakan setiap pendekatan, dan memberikan contoh. Sebelum membaca halaman ini, Anda harus memahami ringkasan Bigtable dan memahami konsep yang terlibat dalam desain skema.
Agar konsisten, deskripsi di halaman ini merujuk pada metode API yang digunakan untuk setiap jenis permintaan. Namun, sebaiknya Anda selalu menggunakan salah satu library klien Bigtable untuk mengakses Bigtable API, bukan menggunakan REST atau RPC.
Contoh di halaman ini menggunakan data sampel yang mirip dengan data yang mungkin Anda simpan di Bigtable.
Untuk mengetahui berapa kali Anda dapat menggunakan operasi yang dijelaskan di halaman ini per hari, lihat Kuota dan batas.
Cara Bigtable menghapus data
Saat Anda mengirim permintaan penghapusan, sel ditandai untuk dihapus dan tidak dapat dibaca. Data akan dihapus hingga seminggu kemudian selama pemadatan, yaitu proses latar belakang yang terus mengoptimalkan tabel. Metadata penghapusan dapat menyebabkan data Anda menggunakan ruang penyimpanan yang sedikit lebih besar (beberapa KB per baris) selama beberapa hari setelah Anda mengirim permintaan penghapusan, hingga pemadatan berikutnya terjadi.
Anda dapat mengirim permintaan penghapusan kapan saja, meskipun cluster Anda telah melampaui batas penyimpanan dan operasi baca dan tulis diblokir.
Menghapus rentang baris
Jika Anda ingin menghapus data dalam jumlah besar yang disimpan dalam baris yang berdekatan, gunakan
dropRowRange
. Operasi ini menghapus semua baris untuk rentang baris yang diidentifikasi
oleh baris awal dan akhir atau awalan kunci baris.
Nilai kunci baris yang Anda berikan saat menghapus rentang baris diperlakukan sebagai data layanan. Untuk mengetahui informasi tentang cara data layanan ditangani, lihat Google Cloud Pemberitahuan Privasi.
Setelah penghapusan berhasil diselesaikan dan Anda menerima respons, Anda dapat menulis data dengan aman ke rentang baris yang sama.
Operasi dropRowRange
memiliki batasan berikut:
- Anda tidak dapat melepaskan rentang baris dari tampilan yang diotorisasi.
- Anda tidak dapat memanggil metode
dropRowRange
secara asinkron. Jika Anda mengirim permintaandropRowRange
ke tabel saat permintaan lain sedang berlangsung, Bigtable akan menampilkan errorUNAVAILABLE
dengan pesanA DropRowRange operation is already ongoing
. Untuk mengatasi error, kirim permintaan lagi. - Dengan instance yang menggunakan replikasi, perlu diketahui bahwa Bigtable mungkin memerlukan waktu yang lama untuk menyelesaikan operasi karena peningkatan latensi replikasi dan penggunaan CPU. Untuk menghapus data dari instance yang menggunakan replikasi, gunakan Data API untuk membaca, lalu menghapus data Anda.
Contoh kode berikut menunjukkan cara menghilangkan rentang baris yang dimulai dengan
awalan kunci baris phone#5c10102
:
Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.
Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.
Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Node.js
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.
Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Menghapus data menggunakan metode Data API
Jika Anda perlu menghapus sejumlah kecil data yang tidak berdekatan, menghapus data menggunakan metode yang memanggil Cloud Bigtable API (Data API) sering kali merupakan pilihan terbaik. Gunakan metode ini jika Anda menghapus data dalam MB, bukan GB, dalam permintaan. Penggunaan Data API adalah satu-satunya cara untuk menghapus data dari kolom (bukan family kolom).
Metode Data API memanggil MutateRows
dengan salah satu dari tiga jenis mutasi:
- DeleteFromColumn
- DeleteFromFamily
- DeleteFromRow
Permintaan penghapusan menggunakan Data API bersifat atomik: permintaan berhasil dan semua data dihapus, atau permintaan gagal dan tidak ada data yang dihapus.
Dalam sebagian besar kasus, hindari penggunaan metode CheckAndMutate
untuk menghapus data. Dalam kasus yang jarang terjadi
saat Anda memerlukan konsistensi yang kuat, Anda dapat menggunakan
pendekatan ini, tetapi perlu diketahui bahwa pendekatan ini membutuhkan banyak resource dan performa mungkin
terpengaruh.
Untuk menggunakan MutateRows
guna menghapus data, Anda mengirim permintaan readRows
dengan
filter untuk menentukan apa yang ingin Anda hapus, lalu Anda mengirim permintaan
penghapusan. Untuk mengetahui daftar filter yang tersedia, lihat
Filter.
Contoh di bagian ini mengasumsikan bahwa Anda telah menentukan data yang akan dihapus.
Menghapus dari kolom
Contoh kode berikut menunjukkan cara menghapus semua sel dari kolom dalam baris:
Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.
Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.
Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Python asyncio
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.
Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Node.js
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.
Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Menghapus dari family kolom
Contoh kode berikut menunjukkan cara menghapus sel dari grup kolom dalam baris:
Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.
Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.
Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Python asyncio
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.
Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Node.js
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.
Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Menghapus dari baris
Cuplikan kode berikut menunjukkan cara menghapus semua sel dari baris:
Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.
Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.
Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Python asyncio
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.
Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Node.js
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.
Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Menghapus dengan streaming dan batch
Mengalirkan dan mengelompokkan permintaan penghapusan sering kali merupakan cara terbaik untuk menghapus data dalam jumlah besar. Strategi ini dapat berguna jika Anda memiliki persyaratan retensi data yang lebih terperinci daripada yang diizinkan oleh kebijakan pengumpulan sampah.
Jika aplikasi Anda ditulis dalam Java, Anda dapat mengaktifkan kontrol alur penulisan batch saat mengirim penghapusan batch ke Bigtable. Untuk mengetahui informasi selengkapnya, lihat Kontrol alur penulisan batch dan Mengaktifkan kontrol alur penulisan batch.
Contoh kode berikut memulai aliran data (membaca baris), mengelompokkannya, lalu memproses kelompok tersebut dan menghapus semua sel di kolom data_plan_01gb1
dalam grup kolom cell_plan
:
Go
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.
Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.
Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.
Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Python asyncio
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.
Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Node.js
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.
Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Menghapus data dalam tampilan yang diizinkan
Anda dapat menghapus data tabel dengan mengirim permintaan penghapusan ke tampilan yang diberi otorisasi. Anda harus menggunakan salah satu dari berikut ini:
- gcloud CLI
- Klien Bigtable untuk Java
Saat menghapus data dari tampilan yang diotorisasi, Anda memberikan ID tampilan yang diotorisasi selain ID tabel.
Data yang dapat Anda hapus dari tampilan yang diizinkan dibatasi oleh
definisi tampilan yang diizinkan. Anda hanya dapat menghapus data yang disertakan dalam
tampilan yang diotorisasi. Jika Anda mencoba menghapus data yang berada di luar definisi tampilan yang diizinkan atau tunduk pada aturan berikut, error PERMISSION_DENIED
akan ditampilkan:
- Menghapus rentang baris dari tampilan yang diberi otorisasi menggunakan
DropRowRange
di Admin API tidak didukung. - Penghapusan dari baris tidak didukung.
- Penghapusan dari kolom didukung selama untuk baris yang ada di tabel virtual yang diberi otorisasi.
- Penghapusan dari grup kolom hanya diizinkan jika grup kolom yang ditentukan dikonfigurasi untuk mengizinkan semua awalan penentu kolom (
qualifier_prefixes=""
) dalam tampilan yang diizinkan.
Misalnya, jika Anda mencoba menghapus dari baris tertentu, dan baris tersebut berisi kolom dalam tabel pokok yang tidak ada dalam tampilan yang diizinkan, permintaan akan gagal.