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 penggunaan Cloud Firestore dan informasi kuota.

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 atau array 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.

    1. Jika belum melakukannya, aktifkan penagihan untuk project Anda di Cloud Platform Console.
    2. Buka halaman Setelan Aplikasi App Engine di Cloud Platform Console.
    3. Klik Edit, lalu tetapkan batas Pengeluaran harian.
    4. 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.