Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

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 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 GooglenCloud 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 satu titik (.) atau dua 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 satu titik (.) atau dua 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 jalur kolom
  • Harus memisahkan nama kolom dengan satu titik (.)
  • 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 diawali 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 operasi tulis yang dapat diteruskan ke operasi Commit atau dilakukan dalam transaksi 500
Jumlah maksimum transformasi kolom yang dapat dilakukan di 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 cara Cloud Firestore menghitung ukuran entri indeks, baca bagian 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
    • Sepuluh 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 yang tidak terduga pada tagihan Anda, tetapkan anggaran bulanan dan pemberitahuan.

    Menetapkan anggaran bulanan

    Untuk melacak biaya Cloud Firestore, buat anggaran bulanan di Cloud Platform Console. Anggaran tidak akan membatasi penggunaan, tetapi Anda dapat menyiapkan pemberitahuan saat 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 pemberitahuan default atau mengubah pemberitahuan yang sudah ada untuk mengirim notifikasi saat mencapai persentase tertentu dari anggaran bulanan Anda.

    Pelajari cara menetapkan anggaran di Cloud Platform Console lebih lanjut.

    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.