Penggunaan dan batas penggunaan

Gunakan panduan ini untuk memahami batas Cloud Firestore dan lihat Harga Cloud Firestore untuk penjelasan lengkap mengenai biaya Cloud Firestore, termasuk berbagai hal yang harus diperhatikan.

Memantau penggunaan Anda

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

Penggunaan terperinci dalam Google Cloud Platform Console

Saat membuat project Firebase, Anda juga membuat project di Google Cloud Platform. Halaman Kuota App Engine di Cloud Platform Console melacak informasi penggunaan Cloud Firestore tambahan, seperti data yang disimpan dan jalan keluar jaringan.

Kuota gratis

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

Kuota diterapkan setiap hari dan disetel ulang pada tengah malam waktu Pasifik.

Tingkatan gratis	Kuota
Data tersimpan	1 GiB
Pembacaan dokumen	50.000 per hari
Penulisan dokumen	20.000 per hari
Penghapusan dokumen	20.000 per hari
Egress jaringan	10 GiB per bulan

Batas standar

Tabel berikut menunjukkan batas yang berlaku untuk penggunaan Cloud Firestore Anda.

Koleksi, dokumen, dan kolom

Batas	Detail
Batasan pada ID koleksi	Harus berupa karakter UTF-8 yang valid Tidak boleh lebih dari 1.500 byte Tidak boleh berisi garis miring ke depan (`/`) Tidak boleh hanya terdiri dari 1 titik (`.`) atau 2 titik (`..`) Tidak boleh cocok dengan ekspresi reguler `__.*__`
Kedalaman maksimum subkoleksi	100
Batasan pada ID dokumen	Harus berupa karakter UTF-8 yang valid Tidak boleh lebih dari 1.500 byte Tidak boleh berisi garis miring ke depan (`/`) Tidak boleh hanya terdiri dari 1 titik (`.`) atau 2 titik (`..`) Tidak boleh cocok dengan ekspresi reguler `__.*__`
Ukuran maksimum untuk nama dokumen	6 KiB
Ukuran maksimum untuk dokumen	1 MiB (1.048.576 byte)
Batasan pada nama kolom	Harus berupa karakter UTF-8 yang valid
Ukuran maksimum nama kolom	1.500 byte
Batasan pada lokasi kolom	Harus memisahkan nama kolom dengan titik tunggal (`.`) Harus menyertakan setiap nama kolom dengan tanda kutip tunggal terbalik, kecuali jika nama kolom tersebut memenuhi persyaratan berikut: Nama kolom hanya berisi karakter `a-z`, `A-Z`, `0-9`, dan garis bawah (`_`) Nama kolom tidak dimulai dengan `0-9`
Ukuran maksimum lokasi kolom	1.500 byte
Ukuran maksimum nilai kolom	1 MiB - 89 byte (1.048.487 byte)
Kedalaman maksimum kolom dalam peta	20

Penulisan dan transaksi

Batas	Detail
Ukuran permintaan API maksimum	10 MiB
Penulisan maksimum per detik per database	10.000 (hingga 10 MiB per detik)
Kecepatan penulisan maksimum untuk dokumen	1 per detik
Kecepatan penulisan maksimum untuk koleksi, dengan dokumen berisi nilai yang berurutan dalam kolom terindeks	500 per detik
Jumlah maksimum penulisan yang dapat diteruskan ke operasi `Commit` atau dilakukan dalam transaksi	500
Jumlah maksimum transformasi kolom yang dapat dilakukan pada satu dokumen dalam operasi `Commit` atau dalam transaksi	500
Batas waktu untuk transaksi	270 detik, dengan masa tenggang 60 detik

Update realtime

Batas	Detail
Koneksi serentak maksimum untuk klien seluler/web per database	1.000.000

Indeks

Batas berikut berlaku untuk indeks kolom tunggal dan indeks gabungan:

Batas	Detail
Jumlah maksimum indeks gabungan untuk database	200
Jumlah maksimum pengecualian indeks kolom tunggal untuk database	200
Jumlah maksimum entri indeks untuk setiap dokumen	40.000 Jumlah entri indeks adalah jumlah dari hal berikut untuk dokumen: Jumlah entri indeks kolom tunggal Jumlah entri indeks gabungan
Ukuran maksimum entri indeks	7,5 KiB Untuk melihat bagaimana Cloud Firestore menghitung ukuran entri indeks, lihat ukuran entri indeks.
Jumlah maksimum ukuran entri indeks pada dokumen	8 MiB Ukuran total adalah jumlah dari hal berikut untuk dokumen: Jumlah ukuran entri indeks kolom tunggal pada dokumen Jumlah ukuran entri indeks gabungan pada dokumen
Ukuran maksimum nilai kolom yang diindeks	1.500 byte Nilai kolom di atas 1.500 byte akan terpotong. Kueri yang mencakup nilai kolom terpotong dapat menampilkan hasil yang tidak konsisten.

Aturan keamanan

Batas	Detail
Jumlah maksimum panggilan `exists()`, `get()`, dan `getAfter()` per permintaan	10 untuk permintaan dokumen tunggal dan permintaan kueri. 20 untuk pembacaan, transaksi, dan penulisan batch multi-dokumen. Batas 10 sebelumnya juga berlaku untuk setiap operasi. Misalnya, bayangkan Anda membuat permintaan penulisan batch dengan 3 operasi penulisan dan aturan keamanan yang menggunakan 2 panggilan akses dokumen untuk memvalidasi setiap penulisan. Dalam hal ini, setiap penulisan menggunakan 2 dari 10 panggilan aksesnya dan permintaan penulisan batch menggunakan 6 dari 20 panggilan aksesnya. Melebihi salah satu batas akan menyebabkan error izin ditolak. Beberapa panggilan akses dokumen dapat di-cache, dan panggilan yang di-cache tidak diperhitungkan batasnya.
Kedalaman maksimum panggilan fungsi	20
Jumlah maksimum panggilan rekursif atau fungsi siklis	0 (tidak diizinkan)
Jumlah maksimum ekspresi yang dievaluasi per permintaan	1.000
Ukuran maksimum kumpulan aturan	64 KB

Mengelola pengeluaran

Untuk membantu menghindari tagihan tak terduga atas tagihan Anda, tetapkan batas dan peringatan pengeluaran.

Menetapkan batas pengeluaran harian

Untuk membatasi penggunaan Cloud Firestore Anda, tetapkan batas pengeluaran harian melalui Google App Engine. Dengan App Engine, Anda dapat menetapkan batas pengeluaran harian pada resource yang terkait dengan App Engine, termasuk Cloud Firestore. Batas App Engine tidak berlaku untuk produk Firebase lainnya.

Jika belum melakukannya, aktifkan penagihan untuk project Anda di Cloud Platform Console.
Buka halaman Setelan Aplikasi App Engine di Cloud Platform Console.
Klik Edit, lalu tetapkan batas Pengeluaran harian.
Klik Simpan. Batas baru akan segera diberlakukan dan disetel ulang setiap hari.

Menetapkan anggaran bulanan

Untuk melacak biaya Cloud Firestore, buat anggaran bulanan di Cloud Platform Console. Anggaran tidak akan membatasi penggunaan, namun Anda dapat menetapkan peringatan untuk memberi tahu jika Anda mendekati atau melampaui biaya yang direncanakan untuk bulan tersebut.

Untuk menetapkan anggaran, buka bagian Penagihan di Cloud Platform Console dan buat anggaran untuk akun penagihan Anda. Anda dapat menggunakan setelan peringatan default atau mengubah peringatan yang sudah ada untuk mengirim notifikasi pada berbagai persentase dari anggaran bulanan Anda.

Pelajari lebih lanjut tentang cara menetapkan anggaran di Cloud Platform Console.