Memahami penagihan Cloud Firestore

Dokumen ini menjelaskan detail harga Cloud Firestore.

Jika Anda melakukan pembayaran dengan mata uang selain USD, yang berlaku adalah harga yang tercantum dalam mata uang Anda pada SKU Cloud Platform.

Ringkasan harga

Saat menggunakan Cloud Firestore, Anda dikenai biaya untuk hal-hal berikut:

• Jumlah dokumen yang Anda baca, tulis, dan hapus.
• Jumlah entri indeks yang cocok dengan kueri agregasi. Anda dikenai biaya satu pembacaan dokumen untuk setiap batch hingga 1.000 entri indeks yang cocok dengan kueri.
• Jumlah penyimpanan yang digunakan database Anda, termasuk overhead untuk metadata dan indeks.
• Jumlah bandwidth jaringan yang digunakan.

Penggunaan bandwidth dan penyimpanan dihitung dalam gigabyte (GiB), dengan 1 GiB = 2³⁰ byte. Semua biaya akan diakumulasikan per hari.

Bagian berikut ini menjelaskan secara detail biaya yang ditagihkan kepada Anda atas penggunaan Cloud Firestore.

Kuota gratis

Cloud Firestore menawarkan kuota gratis, sehingga Anda dapat memulai tanpa biaya. Jumlah kuota gratis tersebut tercantum di bawah ini. Jika memerlukan kuota lebih banyak, Anda harus mengaktifkan penagihan untuk project Google Cloud.

Kuota diterapkan setiap hari dan direset pada tengah malam waktu Pasifik.

Hanya database (default) yang memenuhi syarat untuk mendapatkan kuota gratis.

Paket gratis	Kuota
Data tersimpan	1 GiB
Pembacaan dokumen	50.000 per hari
Penulisan dokumen	20.000 per hari
Penghapusan dokumen	20.000 per hari
Traffic keluar jaringan	10 GiB per bulan

Operasi dan fitur berikut tidak mencakup penggunaan gratis. Anda harus mengaktifkan penagihan untuk menggunakan fitur ini:

• Penghapusan TTL
• Data PITR
• Data pencadangan
• Operasi pemulihan

Untuk mengetahui informasi selengkapnya tentang cara penagihan fitur ini, lihat Harga penyimpanan.

Harga berdasarkan lokasi

Tabel berikut mencantumkan harga untuk pembacaan, penulisan, penghapusan, dan penyimpanan untuk setiap lokasi Cloud Firestore:

Pilih region

Jika Anda melakukan pembayaran dengan mata uang selain USD, yang berlaku adalah harga yang tercantum dalam mata uang Anda di SKU Cloud Platform.

Pembacaan, penulisan, dan penghapusan

Anda dikenai biaya untuk setiap pembacaan, penulisan, dan penghapusan dokumen yang dilakukan dengan Cloud Firestore.

Pengenaan biaya untuk penulisan dan penghapusan dihitung dengan mudah. Untuk operasi tulis, setiap operasi set atau update dihitung satu penulisan.

Namun, harap diperhatikan bahwa pengenaan biaya untuk pembacaan sedikit berbeda. Bagian berikut ini akan menjelaskan perbedaan tersebut secara mendetail.

Kueri agregasi

Untuk kueri agregasi seperti count(), sum(), dan avg(), Anda dikenai biaya pembacaan satu dokumen untuk setiap batch hingga 1.000 entri indeks yang cocok dengan kueri. Untuk kueri agregasi yang cocok dengan 0 entri indeks, ada biaya minimum pada satu pembacaan dokumen.

Misalnya, operasi count() yang cocok antara 0 dan 1.000 entri indeks akan ditagih untuk satu pembacaan dokumen. Untuk operasi count() yang cocok dengan 1.500 entri indeks, Anda akan ditagih 2 pembacaan dokumen.

Memproses hasil kueri

Dengan Cloud Firestore, Anda bisa memproses hasil kueri dan mendapatkan pembaruan realtime saat hasil kueri berubah.

Saat memproses hasil kueri, Anda akan dikenai biaya pembacaan setiap kali terdapat penambahan atau pembaruan dokumen di kumpulan hasil. Anda juga dikenai biaya pembacaan ketika dokumen dihapus dari kumpulan hasil karena dokumen telah berubah. (Sebaliknya, saat dokumen dihapus, Anda tidak dikenai biaya pembacaan.)

Penagihan pemroses di SDK seluler dan web juga bergantung pada apakah persistensi offline diaktifkan atau tidak:

• Jika persistensi offline diaktifkan dan pemroses tidak terhubung selama lebih dari 30 menit (misalnya, jika pengguna offline), Anda akan dikenai biaya pembacaan karena dianggap telah mengeluarkan kueri baru.

• Jika persistensi offline dinonaktifkan, Anda akan dikenai biaya pembacaan karena dianggap telah mengeluarkan kueri baru setiap kali pemroses tidak terhubung dan terhubung kembali.

Mengelola kumpulan hasil yang besar

Cloud Firestore memiliki beberapa fitur yang dapat membantu Anda mengelola kueri yang menampilkan hasil dalam jumlah besar:

• Cursor, membuat Anda dapat melanjutkan kueri yang telah berjalan lama.
• Page token, membantu Anda memberi nomor pada hasil kueri.
• Limit, menentukan berapa banyak hasil yang akan diambil.
• Offset, membuat Anda dapat melewati sejumlah dokumen tertentu.

Penggunaan cursor, page token, dan limit tidak dikenai biaya tambahan. Tidak hanya itu, semua fitur tersebut dapat membantu menghemat uang hanya dengan membaca dokumen yang Anda butuhkan.

Namun, jika terdapat offset dalam kueri yang dikirim, Anda dikenai biaya pembacaan untuk setiap dokumen yang dilewatkan. Misalnya, jika kueri menggunakan offset 10, dan kueri tersebut menampilkan 1 dokumen, Anda akan dikenai biaya untuk 11 pembacaan. Karena biaya tambahan ini, Anda harus menggunakan cursor dan bukan offset, jika memungkinkan.

Kueri selain pembacaan dokumen

Untuk kueri selain pembacaan dokumen, seperti permintaan daftar ID koleksi, Anda dikenai biaya untuk pembacaan satu dokumen. Jika diperlukan lebih dari satu permintaan untuk mengambil kumpulan hasil yang lengkap (misalnya, jika menggunakan penomoran halaman), Anda akan dikenai biaya sebanyak satu kali per permintaan.

Biaya minimum untuk kueri

Terdapat biaya minimum pada satu pembacaan dokumen untuk setiap kueri yang Anda lakukan, meskipun kueri tidak menampilkan hasil apa pun.

Aturan Keamanan Cloud Firestore

Untuk library klien seluler dan web, jika Aturan Keamanan Cloud Firestore menggunakan exists(), get(), atau getAfter() untuk membaca satu atau beberapa dokumen dari database, Anda akan dikenai biaya bacaan tambahan sebagai berikut:

• Anda dikenai biaya pembacaan yang dibutuhkan untuk mengevaluasi Aturan Keamanan Cloud Firestore.

  Misalnya, jika aturan Anda mengacu pada tiga dokumen, tetapi Cloud Firestore hanya perlu membaca dua dokumen untuk mengevaluasi aturan, Anda akan dikenai biaya untuk dua pembacaan tambahan terhadap dokumen tertanggung.

  Anda hanya dikenai biaya untuk satu kali pembacaan per dokumen tertanggung, bahkan jika dokumen tersebut dirujuk lebih dari satu kali oleh aturan Anda.

• Anda hanya dikenai biaya untuk evaluasi aturan sebanyak satu kali per permintaan.

  Oleh karena itu, biaya pembacaan banyak dokumen menjadi lebih murah daripada membaca dokumen satu per satu, karena permintaan yang dibutuhkan lebih sedikit untuk membaca beberapa dokumen sekaligus.

• Saat memproses hasil kueri, Anda dikenai biaya untuk evaluasi aturan dalam semua kasus berikut:

  • Saat Anda mengeluarkan kueri.
  • Setiap kali hasil kueri diperbarui.
  • Kapan pun perangkat pengguna offline, lalu kembali online.
  • Kapan pun Anda mengubah aturan.
  • Kapan pun Anda memperbarui dokumen tertanggung dalam aturan.

Ukuran penyimpanan database

Anda dikenai biaya untuk jumlah data yang disimpan di Cloud Firestore, termasuk overhead penyimpanan. Jumlah overhead meliputi metadata, indeks otomatis, dan indeks gabungan.

Setiap dokumen yang tersimpan di Cloud Firestore membutuhkan metadata berikut:

• ID dokumen, termasuk ID koleksi dan nama dokumen.
• Nama dan nilai setiap kolom. Karena Cloud Firestore tidak memiliki skema, nama setiap kolom dalam dokumen harus disimpan dengan nilai kolom.
• Indeks gabungan dan indeks satu kolom yang mengacu pada dokumen. Setiap entri indeks akan berisi ID koleksi; sejumlah nilai kolom, bergantung pada definisi indeks; dan nama dokumen.

Biaya penyimpanan dalam GiB/bulan dan dihitung setiap hari. Cloud Firestore mengukur ukuran database setiap hari. Selama sebulan, titik contoh ini dirata-ratakan untuk menghitung ukuran penyimpanan database. Nilai rata-rata ini dikalikan dengan harga satuan penyimpanan (GiB-bulan)

Pelajari cara menghitung penyimpanan Cloud Firestore di Perhitungan Ukuran Penyimpanan.

Data PITR

Jika mengaktifkan PITR, Anda akan dikenai biaya untuk penyimpanan data PITR. Sebagian besar pelanggan akan menemukan bahwa biaya keseluruhan penyimpanan data PiTR hampir sama dengan biaya penyimpanan database.

Biaya penyimpanan untuk PITR adalah dalam GiB/bulan dan dihitung setiap hari. Cloud Firestore mengukur ukuran database setiap hari. Selama sebulan, titik contoh ini dirata-ratakan untuk menghitung ukuran penyimpanan database. Nilai rata-rata ini dikalikan dengan harga satuan PITR (GiB-bulan).

Misalnya, jika ukuran rata-rata database Anda selama satu bulan adalah 1 GiB dan PITR diaktifkan untuk satu bulan penuh, maka ukuran data PITR yang dapat ditagih juga 1 GiB.

Penagihan minimum: Anda dapat ditagih hingga 1 hari biaya penyimpanan PITR meskipun Anda menonaktifkan PITR dalam satu hari setelah pengaktifan.

Operasi pencadangan dan pemulihan data

Jika Anda mengaktifkan pencadangan, Anda akan dikenai biaya untuk penyimpanan cadangan database. Ukuran penyimpanan untuk cadangan sama dengan ukuran penyimpanan database saat Anda mengambil cadangan.

Biaya penyimpanan untuk cadangan adalah dalam GiB/bulan. Selama periode sebulan, jumlah hari saat setiap cadangan dipertahankan dan rata-rata selama sebulan juga akan dihitung. Biaya setiap cadangan dihitung menggunakan ukuran penyimpanan cadangan dikalikan dengan proporsi bulan saat cadangan dipertahankan, dikalikan dengan harga satuan.

Saat Anda melakukan operasi pemulihan, Cloud Firestore mengukur ukuran cadangan untuk operasi pemulihan. Ukuran cadangan dikalikan dengan harga satuan operasi pemulihan (GiB).

Bandwidth jaringan

Anda dikenai biaya untuk bandwidth jaringan yang digunakan oleh permintaan Cloud Firestore, seperti ditunjukkan pada bagian berikut. Biaya bandwidth jaringan permintaan Cloud Firestore tergantung pada ukuran respons permintaan, lokasi database Cloud Firestore, dan tujuan respons.

Cloud Firestore menghitung ukuran respons berdasarkan format pesan yang diserialkan. Overhead protokol, seperti overhead SSL, tidak diperhitungkan terhadap penggunaan bandwidth jaringan. Permintaan yang ditolak oleh Aturan Keamanan Cloud Firestore tidak diperhitungkan dalam penggunaan bandwidth jaringan.

Untuk mengetahui jumlah bandwidth jaringan yang telah digunakan, Anda dapat menggunakan GCP Console untuk mengekspor data penagihan ke file.

Harga jaringan umum

Untuk permintaan yang berasal dari Google Cloud Platform (misalnya, dari aplikasi yang berjalan di Google Compute Engine), Anda dikenai biaya sebagai berikut:

Jenis traffic	Harga
Masuk	Gratis
Keluar dalam suatu region	Gratis
Keluar antar-region di multi-region yang sama	Gratis
Keluar antar-region di AS (per GiB)	$0,01 (gratis 10 GiB pertama per bulan)
Traffic keluar antar-region, tidak termasuk traffic antar region AS	Tarif keluar internet untuk Google Cloud Platform

Jika Anda melakukan pembayaran dengan mata uang selain USD, yang berlaku adalah harga yang tercantum dalam mata uang Anda di SKU Cloud Platform.

Cloud Firestore juga dikenai tarif keluar internet tambahan untuk hal berikut:

• Permintaan Google Cloud antar-region, tidak termasuk traffic antar-region AS
• Permintaan dari luar Google Cloud (misalnya, dari perangkat seluler pengguna)

Lihat tarif traffic keluar internet Google Cloud.

Lihat contoh harga

Untuk mengetahui cara akumulasi biaya penagihan Cloud Firestore dalam contoh aplikasi nyata, lihat contoh penagihan Cloud Firestore.

Mengelola pengeluaran

Untuk membantu menghindari tagihan yang tidak terduga pada tagihan Anda, setel anggaran dan pemberitahuan bulanan menggunakan konsol penagihan Google Cloud.

Untuk memantau penggunaan Cloud Firestore, buka tab Usage untuk Cloud Firestore di Firebase Console. Gunakan dasbor tersebut untuk mengukur penggunaan Anda selama periode waktu yang berbeda.