Anda dapat menggunakan layanan hapus massal terkelola Cloud Firestore untuk menghapus data dari database Anda. Fitur ini mendukung penghapusan terhadap satu atau beberapa grup koleksi.
Halaman ini menjelaskan cara menghapus dokumen Cloud Firestore secara massal menggunakan layanan hapus massal terkelola. Layanan
penghapusan massal terkelola Cloud Firestore tersedia melalui
alat command line gcloud
dan Cloud Firestore
API (REST, RPC).
Sebelum memulai
Sebelum dapat menggunakan layanan penghapusan massal terkelola, Anda harus menyelesaikan tugas-tugas berikut:
- Aktifkan penagihan untuk project Google Cloud. Hanya project Google Cloud dengan penagihan aktif yang dapat menggunakan fungsi penghapusan massal.
-
Pastikan akun Anda memiliki izin yang diperlukan untuk Cloud Firestore. Jika Anda adalah pemilik project, akun Anda memiliki izin yang diperlukan. Jika tidak, peran berikut dapat memberikan izin yang diperlukan untuk operasi penghapusan massal:
- Peran Cloud Firestore:
Owner
,Cloud Datastore Owner
, atauCloud Datastore Bulk Admin
- Peran Cloud Firestore:
Menyiapkan gcloud
untuk project Anda
Anda dapat memulai operasi penghapusan massal melalui Konsol Google Cloud atau alat command line gcloud
. Untuk menggunakan gcloud
, siapkan alat command-line dan hubungkan ke project Anda dengan salah satu cara berikut:
Akses
gcloud
dari konsol Google Cloud menggunakan Cloud Shell.Pastikan
gcloud
dikonfigurasi untuk project yang tepat:gcloud config set project [PROJECT_ID]
Menghapus data secara massal
Operasi penghapusan massal pertama-tama akan menemukan semua dokumen yang berlaku di database Anda, lalu menghapusnya secara massal. Anda masih dapat mengajukan kueri atau membaca dokumen ini sementara hasilnya mungkin bervariasi berdasarkan progres yang dilakukan. Penghapusan massal tidak akan menghapus dokumen yang ditambahkan atau diubah setelah operasi dimulai.
Menghapus grup koleksi tertentu secara massal
gcloud
Untuk menghapus grup koleksi tertentu secara massal, gunakan flag --collection-ids
. Operasi hanya menghapus
grup koleksi dengan ID yang diberikan. Grup koleksi mencakup semua dokumen dan dokumen bertingkat (di jalur mana pun) dengan grup koleksi yang ditentukan.
gcloud beta firestore bulk-delete \ --collection-ids=[COLLECTION_GROUP_ID_1_OR_KIND_1],[COLLECTION_GROUP_ID_2_OR_KIND_2],[SUBCOLLECTION_GROUP_ID_1_OR_KIND_3] \ --database=[DATABASE]
Mengelola operasi penghapusan massal
Setelah Anda memulai operasi penghapusan massal, Cloud Firestore akan menetapkan nama unik pada operasi tersebut. Anda dapat menggunakan nama operasi untuk menghapus, membatalkan, atau memeriksa status operasi.
Nama operasi diawali dengan projects/[PROJECT_ID]/databases/[DATABASE_ID]/operations/
, misalnya:
projects/my-project/databases/(default)/operations/ASA1MTAwNDQxNAgadGx1YWZlZAcSeWx0aGdpbi1zYm9qLW5pbWRhEgopEg
Namun, Anda dapat tidak menyertakan awalan saat menentukan nama operasi untuk perintah describe
, cancel
, dan delete
.
Mencantumkan semua operasi penghapusan massal
gcloud
Gunakan perintah operations list
untuk melihat semua operasi yang sedang berjalan dan baru selesai, termasuk operasi penghapusan massal:
gcloud firestore operations list
Memeriksa status operasi
gcloud
Gunakan perintah operations describe
untuk menampilkan status operasi penghapusan massal.
gcloud firestore operations describe [OPERATION_NAME]
Memperkirakan waktu penyelesaian
Permintaan untuk status operasi yang berjalan lama akan menampilkan metrik workEstimated
dan workCompleted
. Setiap metrik tersebut ditampilkan dalam jumlah byte maupun jumlah dokumen:
workEstimated
menampilkan estimasi total jumlah byte dan dokumen yang akan diproses oleh sebuah operasi. Cloud Firestore mungkin menghilangkan metrik ini jika tidak dapat membuat perkiraan.workCompleted
menunjukkan jumlah byte dan dokumen yang dihapus sejauh ini. Setelah operasi selesai, nilai akan menunjukkan jumlah total byte dan dokumen yang benar-benar diproses, dan mungkin lebih besar dari nilaiworkEstimated
.
Bagilah workCompleted
dengan workEstimated
untuk mengetahui perkiraan kasar dari progresnya. Perkiraan ini mungkin tidak akurat karena tergantung pada koleksi statistik yang tertunda.
Membatalkan operasi
gcloud
Gunakan perintah operations cancel
untuk menghentikan operasi yang sedang berlangsung:
gcloud firestore operations cancel [OPERATION_NAME]
Membatalkan operasi yang sedang berjalan tidak akan mengurungkan operasi tersebut. Operasi penghapusan massal yang dibatalkan tidak akan memulihkan dokumen yang dihapus.
Menghapus operasi
Gunakan perintah gcloud firestore operations delete
untuk menghapus operasi yang telah selesai dari daftar operasi terbaru. Untuk membatalkan operasi yang sedang berjalan, gunakan operasi pembatalan sebelumnya.
gcloud firestore operations delete [OPERATION_NAME]
Penagihan dan harga untuk operasi penghapusan massal
Anda harus mengaktifkan penagihan untuk project Google Cloud sebelum menggunakan layanan penghapusan massal terkelola.
Operasi penghapusan massal dikenai biaya untuk pembacaan dan penghapusan dokumen sebesar tarif yang tercantum dalam harga Cloud Firestore. Operasi penghapusan massal menimbulkan satu entri indeks yang dibaca per dokumen yang ditemukan dan satu operasi penghapusan per dokumen yang dihapus. Anda dikenai biaya satu operasi baca untuk hingga 1.000 entri indeks yang dibaca. Misalnya, untuk operasi penghapusan massal yang menghapus 1.500 dokumen, Anda akan ditagih dengan 2 pembacaan dokumen dan 1.500 penghapusan dokumen.
Perhatikan bahwa Cloud Firestore menagih berdasarkan pekerjaan yang sebenarnya dilakukan. Jika operasi dibatalkan atau gagal karena error pengguna, Anda akan dikenai biaya atas progres yang dibuat. Cloud Firestore tidak akan mengenakan biaya baca atau hapus untuk dokumen yang pada akhirnya tidak dihapus (misalnya, dokumen yang diubah setelah operasi penghapusan dimulai). Biaya akan diatribusikan pada hari penyelesaian operasi.
Operasi penghapusan massal tidak akan memicu pemberitahuan anggaran Google Cloud Anda hingga operasi selesai. Demikian pula, operasi baca dan hapus yang dilakukan selama operasi penghapusan massal akan diterapkan pada kuota/penggunaan gratis Anda setelah operasi selesai. Operasi penghapusan massal tidak akan memengaruhi penggunaan yang ditampilkan di bagian penggunaan konsol.
Lihat biaya penghapusan massal
Operasi penghapusan massal menerapkan label goog-firestoremanaged:bulkdelete
ke operasi yang ditagih. Di halaman Cloud Billing reports, Anda dapat menggunakan label ini untuk melihat biaya yang terkait dengan operasi penghapusan massal.
Praktik terbaik
Hindari melewati data yang telah dihapus yang dapat memperlambat kueri.