Kuota dan batas

Halaman ini mengidentifikasi kuota dan batas permintaan untuk Firestore.

Penggunaan Paket Gratis

Firestore menawarkan paket gratis yang memungkinkan Anda mulai menggunakan Firestore tanpa biaya. Jumlah paket gratis tercantum dalam tabel berikut.

Jumlah paket gratis diterapkan setiap hari dan direset pada tengah malam waktu Pasifik.

Paket gratis hanya berlaku untuk satu database Firestore per project. Database pertama yang dibuat dalam project tanpa database paket gratis akan mendapatkan paket gratis. Jika database dengan paket gratis yang diterapkan dihapus, database berikutnya yang dibuat akan menerima paket gratis.

Edisi standar

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
Transfer data keluar 10 GiB per bulan

Edisi perusahaan

Paket gratis Kuota
Data tersimpan 1 GiB
Unit operasi baca 50.000 per hari
Unit pembaruan real-time 50.000 per hari
Unit operasi tulis 40.000 per hari
Transfer data keluar 10 GiB per bulan

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

  • Penghapusan terkelola (TTL)
  • Data PITR
  • Mencadangkan data
  • Operasi pemulihan
  • Operasi clone

Batas

Tabel berikut menunjukkan batas yang berlaku untuk Firestore. Ini adalah batas yang tidak dapat dilewati kecuali jika dinyatakan lain.

Database

Edisi standar

Batas Detail
Jumlah maksimum database per project

100

Anda dapat menghubungi dukungan untuk meminta peningkatan batas ini.

Jumlah maksimum database kunci enkripsi yang dikelola pelanggan (CMEK) per project

0

Secara default, kuotanya adalah 0 karena fitur ini hanya bisa digunakan oleh pihak yang masuk dalam daftar yang diizinkan. Anda dapat meminta penambahan kuota dengan mengisi formulir permintaan akses CMEK.

Edisi perusahaan

Batas Detail
Jumlah maksimum database per project

100

Anda dapat menghubungi dukungan untuk meminta peningkatan batas ini.

Jumlah maksimum database kunci enkripsi yang dikelola pelanggan (CMEK) per project

0

Secara default, kuotanya adalah 0 karena fitur ini hanya bisa digunakan oleh pihak yang masuk dalam daftar yang diizinkan. Anda dapat meminta penambahan kuota dengan mengisi formulir permintaan akses CMEK.

Koleksi, dokumen, dan kolom

Edisi standar

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 (/)
  • 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 (/)
  • Tidak boleh hanya terdiri dari satu titik (.) atau dua titik (..)
  • Tidak boleh cocok dengan ekspresi reguler __.*__
  • Jika Anda mengimpor entity Datastore ke database Firestore, ID entity numerik akan diekspos sebagai __id[0-9]+__
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
  • Tidak boleh cocok dengan ekspresi reguler __.*__
Ukuran maksimum nama kolom 1.500 byte
Batasan pada jalur kolom
  • Harus memisahkan nama kolom dengan satu titik (.)
  • Dapat diteruskan sebagai string segmen (.) yang dipisahkan titik, dengan setiap segmen berupa nama kolom sederhana atau nama kolom kutipan (ditentukan di bawah).
Nama kolom sederhana adalah yang memenuhi semua kondisi berikut ini:
  • Hanya berisi karakter a-z, A-Z, 0-9, dan garis bawah (_)
  • Tidak diawali dengan 0-9
Nama kolom yang dikutip dimulai dan diakhiri dengan karakter tanda kutip tunggal terbalik (`). Misalnya, foo.`x&y` mengacu pada kolom x&y yang disusun bertingkatkan pada kolom foo. Untuk membuat nama kolom dengan karakter tanda kutip terbalik, tandai karakter tanda kutip terbalik tersebut dengan karakter garis miring terbalik (\). Untuk kemudahan, Anda dapat menghindari nama kolom yang dikutip dengan meneruskan jalur kolom sebagai objek FieldPath (misalnya, lihat JavaScript FieldPath).
Ukuran maksimum jalur kolom 1.500 byte
Ukuran maksimum nilai kolom 1 MiB - 89 byte (1.048.487 byte)
Kedalaman maksimum kolom dalam peta atau array

20

Kolom peta dan array menambahkan satu tingkat ke kedalaman keseluruhan objek. Misalnya, objek berikut memiliki total kedalaman tiga tingkat: 


{
  nested_map: {         #depth 1
    nested_array: [     #depth 2
      {
        foo: "bar"      #depth 3
      }
    ]
  }
}

Edisi perusahaan

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 (/)
  • 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 (/)
  • Tidak boleh hanya terdiri dari satu titik (.) atau dua titik (..)
  • Tidak boleh cocok dengan ekspresi reguler __.*__
  • Jika Anda mengimpor entity Datastore ke database Firestore, ID entity numerik akan diekspos sebagai __id[0-9]+__
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
  • Tidak boleh cocok dengan ekspresi reguler __.*__
Ukuran maksimum nama kolom 1.500 byte
Batasan pada jalur kolom
  • Harus memisahkan nama kolom dengan satu titik (.)
  • Dapat diteruskan sebagai string segmen (.) yang dipisahkan titik, dengan setiap segmen berupa nama kolom sederhana atau nama kolom kutipan (ditentukan di bawah).
Nama kolom sederhana adalah yang memenuhi semua kondisi berikut ini:
  • Hanya berisi karakter a-z, A-Z, 0-9, dan garis bawah (_)
  • Tidak diawali dengan 0-9
Nama kolom yang dikutip dimulai dan diakhiri dengan karakter tanda kutip tunggal terbalik (`). Misalnya, foo.`x&y` mengacu pada kolom x&y yang disusun bertingkatkan pada kolom foo. Untuk membuat nama kolom dengan karakter tanda kutip terbalik, tandai karakter tanda kutip terbalik tersebut dengan karakter garis miring terbalik (\). Untuk kemudahan, Anda dapat menghindari nama kolom yang dikutip dengan meneruskan jalur kolom sebagai objek FieldPath (misalnya, lihat JavaScript FieldPath).
Ukuran maksimum jalur kolom 1.500 byte
Ukuran maksimum nilai kolom 1 MiB - 89 byte (1.048.487 byte)
Kedalaman maksimum kolom dalam peta atau array

20

Kolom peta dan array menambahkan satu tingkat ke kedalaman keseluruhan objek. Misalnya, objek berikut memiliki total kedalaman tiga tingkat: 


{
  nested_map: {         #depth 1
    nested_array: [     #depth 2
      {
        foo: "bar"      #depth 3
      }
    ]
  }
}

Penulisan dan transaksi

Edisi standar

Batas Detail
Ukuran permintaan API maksimum 10 MiB
Batas waktu untuk transaksi 270 detik, dengan masa tenggang 60 detik
Jumlah maksimum transformasi kolom yang dapat dilakukan di satu dokumen dalam operasi Commit atau dalam suatu transaksi 500

Edisi perusahaan

Batas Detail
Ukuran permintaan API maksimum 10 MiB
Batas waktu untuk transaksi 270 detik, dengan masa tenggang 60 detik
Jumlah maksimum transformasi kolom yang dapat dilakukan di satu dokumen dalam operasi Commit atau dalam suatu transaksi 500

Indeks

Edisi standar

Batas Detail
Jumlah maksimum indeks komposit untuk database
Jumlah maksimum konfigurasi kolom tunggal untuk database

Satu konfigurasi tingkat kolom dapat berisi beberapa konfigurasi untuk kolom yang sama. Misalnya, pengecualian pengindeksan kolom tunggal dan kebijakan TTL pada kolom yang sama dihitung sebagai satu konfigurasi kolom terhadap batas.

Jumlah maksimum entri indeks untuk setiap dokumen

40.000

Jumlah entri indeks adalah jumlah hal berikut untuk dokumen:

  • Jumlah entri indeks kolom tunggal
  • Jumlah entri indeks komposit

Untuk melihat cara Firestore mengubah dokumen dan kumpulan indeks menjadi entri indeks, lihat contoh jumlah entri indeks ini.
Jumlah maksimum kolom dalam indeks komposit 100
Ukuran maksimum entri indeks

7,5 KiB

Untuk melihat cara Firestore menghitung ukuran entri indeks, lihat ukuran entri indeks.
Jumlah maksimum ukuran entri indeks pada dokumen

8 MiB

Ukuran total adalah jumlah hal berikut pada suatu dokumen:

  • Jumlah ukuran entri indeks kolom tunggal pada dokumen
  • Jumlah ukuran entri indeks komposit pada dokumen
    		•
    Ukuran maksimum nilai kolom terindeks

    1.500 byte

    Nilai kolom di atas 1.500 byte akan terpotong. Kueri yang mencakup nilai kolom terpotong dapat menampilkan hasil yang tidak konsisten.

    Edisi perusahaan

    Batas Detail
    Jumlah maksimum indeks untuk database

    Jumlah maksimum entri indeks untuk setiap dokumen

    40.000
    Jumlah maksimum kolom dalam indeks 100
    Ukuran maksimum entri indeks

    7,5 KiB

    Untuk melihat cara Firestore menghitung ukuran entri indeks, lihat ukuran entri indeks.
    Jumlah maksimum ukuran entri indeks pada dokumen

    8 MiB

    Time-to-live (TTL)

    Edisi standar

    Batas Detail
    Jumlah maksimum konfigurasi TTL untuk database

    Edisi perusahaan

    Batas Detail
    Jumlah maksimum konfigurasi kolom tunggal untuk database

    Satu konfigurasi tingkat kolom dapat berisi beberapa konfigurasi untuk kolom yang sama. Misalnya, pengecualian pengindeksan kolom tunggal dan kebijakan TTL pada kolom yang sama dihitung sebagai satu konfigurasi kolom terhadap batas.

    Ekspor/Impor

    Batas berikut berlaku untuk operasi impor dan ekspor terkelola:

    Edisi standar

    Batas Detail
    Jumlah total maksimum permintaan ekspor dan impor untuk project yang diizinkan per menit 20
    Jumlah maksimum ekspor dan impor serentak 50
    Jumlah maksimum filter ID koleksi untuk permintaan ekspor dan impor 100

    Edisi perusahaan

    Batas Detail
    Jumlah total maksimum permintaan ekspor dan impor untuk project yang diizinkan per menit 20
    Jumlah maksimum ekspor dan impor serentak 50
    Jumlah maksimum filter ID koleksi untuk permintaan ekspor dan impor 100

    Aturan keamanan

    Edisi standar

    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 multidokumen. Batas 10 sebelumnya juga berlaku untuk setiap operasi.

      Misalnya, bayangkan Anda membuat permintaan penulisan batch dengan 3 operasi penulisan, dan aturan keamanan 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 disimpan dalam cache, dan panggilan yang disimpan dalam cache tidak diperhitungkan dalam batas tersebut.
    Kedalaman maksimum pernyataan match bertingkat 10
    Panjang jalur maksimum, dalam segmen jalur, yang diizinkan dalam sekumpulan pernyataan match bertingkat 100
    Jumlah maksimum variabel tangkapan jalur yang diizinkan dalam sekumpulan pernyataan match bertingkat 20
    Kedalaman maksimum panggilan fungsi 20
    Jumlah maksimum argumen fungsi 7
    Jumlah maksimum binding variabel let per fungsi 10
    Jumlah maksimum panggilan fungsi siklis atau berulang 0 (tidak diizinkan)
    Jumlah maksimum ekspresi yang dievaluasi per permintaan 1.000
    Ukuran maksimum kumpulan aturan Kumpulan aturan harus mematuhi dua batas ukuran:
    • Batas 256 KB pada ukuran sumber teks kumpulan aturan yang dipublikasikan dari Firebase console atau dari CLI menggunakan firebase deploy.
    • Batas 250 KB pada ukuran kumpulan aturan yang dikompilasi yang dihasilkan saat Firebase memproses sumber dan menjadikannya aktif di back-end.

    Edisi perusahaan

    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 multidokumen. Batas 10 sebelumnya juga berlaku untuk setiap operasi.

      Misalnya, bayangkan Anda membuat permintaan penulisan batch dengan 3 operasi penulisan, dan aturan keamanan 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 disimpan dalam cache, dan panggilan yang disimpan dalam cache tidak diperhitungkan dalam batas tersebut.
    Kedalaman maksimum pernyataan match bertingkat 10
    Panjang jalur maksimum, dalam segmen jalur, yang diizinkan dalam sekumpulan pernyataan match bertingkat 100
    Jumlah maksimum variabel tangkapan jalur yang diizinkan dalam sekumpulan pernyataan match bertingkat 20
    Kedalaman maksimum panggilan fungsi 20
    Jumlah maksimum argumen fungsi 7
    Jumlah maksimum binding variabel let per fungsi 10
    Jumlah maksimum panggilan fungsi siklis atau berulang 0 (tidak diizinkan)
    Jumlah maksimum ekspresi yang dievaluasi per permintaan 1.000
    Ukuran maksimum kumpulan aturan Kumpulan aturan harus mematuhi dua batas ukuran:
    • Batas 256 KB pada ukuran sumber teks kumpulan aturan yang dipublikasikan dari Firebase console atau dari CLI menggunakan firebase deploy.
    • Batas 250 KB pada ukuran kumpulan aturan yang dikompilasi yang dihasilkan saat Firebase memproses sumber dan menjadikannya aktif di back-end.