Menghapus data secara massal

Menghapus data secara massal

Gunakan layanan penghapusan massal terkelola untuk menghapus data dari database Anda. Fitur ini mendukung penghapusan terhadap satu atau beberapa grup koleksi.

Halaman ini menjelaskan cara menghapus dokumen secara massal menggunakan layanan penghapusan massal terkelola. Layanan penghapusan massal terkelola Firestore tersedia melalui alat command line gclouddan Firestore REST API.

Perhatian: Penghapusan massal data dari Firestore akan menimbulkan satu operasi hapus per dokumen yang dihapus dan beberapa operasi baca berdasarkan sebagian kecil dari total dokumen yang dibaca. Namun, operasi ini tidak muncul di bagian penggunaan konsol. Pastikan Anda memahami hal ini sebelum melakukan penghapusan massal untuk menghindari tagihan biaya.

Sebelum memulai

Sebelum dapat menggunakan layanan penghapusan massal terkelola, Anda harus menyelesaikan tugas-tugas berikut:

1. Untuk penghapusan dokumen massal, aktifkan penagihan untuk Google Cloud project Anda. Hanya Google Cloud project yang penagihannya diaktifkan yang dapat menggunakan fungsi penghapusan massal.

2. Pastikan akun Anda memiliki izin yang diperlukan untuk Firestore. Jika Anda adalah pemilik project, berarti akun Anda memiliki izin yang diperlukan. Jika tidak, peran berikut dapat memberikan izin yang diperlukan untuk operasi penghapusan massal:

   • Peran Firestore: Owner, Cloud Datastore Owner, atau Cloud Datastore Bulk Admin
     Catatan: Peran Datastore ini juga memberikan izin di Firestore.

Menyiapkan gcloud untuk project Anda

Anda dapat memulai operasi penghapusan massal melalui konsol atau alat command-line. Google Cloud gcloud Untuk menggunakan gcloud, siapkan alat command line dan hubungkan ke project Anda dengan salah satu cara berikut:

• Akses gcloud dari Google Cloud konsol menggunakan Cloud Shell.

  Mulai Cloud Shell

  Pastikan gcloud dikonfigurasi untuk project yang tepat:

  gcloud config set project [PROJECT_ID]
  

• Instal dan lakukan inisialisasi Google Cloud SDK.

Menghapus data secara massal

Pertama, operasi penghapusan massal akan menemukan semua dokumen yang berlaku di database Anda, lalu menghapusnya secara massal. Anda masih dapat membuat kueri atau membaca dokumen ini, meskipun hasilnya dapat bervariasi berdasarkan progres yang telah dilakukan. Penghapusan massal tidak menghapus dokumen yang ditambahkan atau diubah setelah operasi dimulai.

Catatan: Jika Anda berencana menghapus semua dokumen dalam database, lihat fitur penghapusan database sebagai gantinya.

Menghapus grup koleksi tertentu secara massal

gcloud

Untuk menghapus grup koleksi tertentu secara massal, gunakan flag --collection-ids. Operasi ini hanya menghapus grup koleksi dengan ID yang diberikan.

Catatan: Menghapus koleksi secara massal tidak akan otomatis menghapus semua koleksi turunan. Anda juga perlu menentukan grup koleksi turunan.

gcloud 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, Firestore akan menetapkan nama unik untuk 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 saja 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 baik dalam jumlah byte maupun jumlah dokumen:

• workEstimated menampilkan perkiraan total jumlah byte dan dokumen yang akan diproses oleh operasi. Firestore mungkin akan menghilangkan metrik ini jika tidak dapat membuat perkiraan.

• workCompleted menunjukkan jumlah byte dan dokumen yang dihapus sejauh ini. Setelah operasi selesai, nilai ini akan menampilkan total jumlah byte dan dokumen yang sebenarnya diproses, yang mungkin lebih besar dari nilai workEstimated.

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]

Jika operasi yang sedang berjalan dibatalkan, operasi tersebut tidak akan diurungkan. 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 Google Cloud project sebelum menggunakan layanan penghapusan massal terkelola.

Operasi penghapusan massal dikenai biaya untuk pembacaan dan penghapusan dokumen dengan tarif yang tercantum dalam harga 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 pembacaan hingga 1.000 entri indeks. Misalnya, untuk operasi penghapusan massal yang menghapus 1.500 dokumen, Anda akan dikenai biaya untuk 2 pembacaan dokumen dan 1.500 penghapusan dokumen.

Perhatikan bahwa Firestore mengenakan biaya untuk pekerjaan yang sebenarnya dilakukan. Jika operasi dibatalkan atau gagal karena kesalahan pengguna, Anda akan ditagih berdasarkan progres yang telah dilakukan. Firestore tidak akan mengenakan biaya pembacaan atau penghapusan untuk dokumen yang pada akhirnya tidak dihapus, seperti dokumen yang diubah setelah operasi penghapusan dimulai. Biaya akan dikaitkan pada hari penyelesaian operasi.

Operasi penghapusan massal tidak akan memicu Google Cloud anggaran Anda hingga setelah selesai. Demikian pula, operasi baca dan hapus yang dilakukan selama operasi penghapusan massal akan diterapkan pada penggunaan paket gratis Anda setelah operasi selesai. Operasi penghapusan massal tidak memengaruhi penggunaan yang ditampilkan di bagian penggunaan konsol.

Melihat 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 dihapus karena dapat memperlambat kueri.