Join us in person and online for Firebase Summit on October 18, 2022. Learn how Firebase can help you accelerate app development, release your app with confidence, and scale with ease. Register now

Kullanım ve sınırlar

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Cloud Firestore sınırlarını anlamak için bu kılavuzu kullanın ve dikkat edilmesi gerekenler de dahil olmak üzere Cloud Firestore maliyetlerinin tam ve ayrıntılı açıklaması için Cloud Firestore Fiyatlandırmasına bakın.

Kullanımınızı izleyin

Cloud Firestore kullanımınızı izlemek için Firebase konsolunda Cloud Firestore Kullanımı sekmesini açın . Farklı zaman dilimlerinde kullanımınızı ölçmek için gösterge tablosunu kullanın.

Google Cloud Console'da ayrıntılı kullanım

Bir Firebase projesi oluşturduğunuzda, aynı zamanda bir Google Cloud projesi de yaratmış olursunuz. Google Cloud Console'daki App Engine Kotaları sayfası, Cloud Firestore kullanımını ve kota bilgilerini izler.

Ücretsiz kota

Cloud Firestore, ücretsiz olarak başlamanıza olanak tanıyan ücretsiz kota sunar. Ücretsiz kota miktarları aşağıda listelenmiştir. Daha fazla kotaya ihtiyacınız varsa , Bulut Platformu projeniz için faturalandırmayı etkinleştirmeniz gerekir.

Kotalar günlük olarak uygulanır ve Pasifik saatiyle gece yarısı civarında sıfırlanır.

Ücretsiz katman Kota
Depolanmış veri 1 GiB
Belge okumaları günde 50.000
Belge yazıyor günde 20.000
Belge siler günde 20.000
ağ çıkışı ayda 10 GiB

Standart limitler

Aşağıdaki tablolar, Cloud Firestore için geçerli olan sınırları göstermektedir. Aksi belirtilmedikçe bunlar zor sınırlardır.

Koleksiyonlar, belgeler ve alanlar

sınır Detaylar
Koleksiyon kimlikleri üzerindeki kısıtlamalar
  • Geçerli UTF-8 karakterleri olmalıdır
  • 1500 bayttan uzun olmamalıdır
  • Eğik çizgi ( / ) içeremez
  • Yalnızca tek bir noktadan ( . ) veya çift noktadan ( .. ) oluşamaz.
  • __.*__ normal ifadesiyle eşleşemez
Alt koleksiyonların maksimum derinliği 100
Belge kimlikleri üzerindeki kısıtlamalar
  • Geçerli UTF-8 karakterleri olmalıdır
  • 1500 bayttan uzun olmamalıdır
  • Eğik çizgi ( / ) içeremez
  • Yalnızca tek bir noktadan ( . ) veya çift noktadan ( .. ) oluşamaz.
  • __.*__ normal ifadesiyle eşleşemez
  • Datastore varlıklarını bir Firestore veritabanına aktarırsanız sayısal varlık kimlikleri __id[0-9]+__ olarak gösterilir
Bir belge adı için maksimum boyut 6 KiB
Bir belge için maksimum boyut 1 MiB (1.048.576 bayt)
Alan adları üzerindeki kısıtlamalar Geçerli UTF-8 karakterleri olmalıdır
Bir alan adının maksimum boyutu 1500 bayt
Alan yollarındaki kısıtlamalar
  • Alan adları tek nokta ( . ) ile ayrılmalıdır.
  • Yoldaki tüm alan adları basit olduğunda bir dize olarak iletilebilir, aksi takdirde bir FieldPath nesnesi olarak iletilmelidir ( örneğin JavaScript FieldPath )
Basit bir alan adı, aşağıdakilerin hepsinin doğru olduğu bir addır:
  • Yalnızca az , AZ , 0-9 ve alt çizgi ( _ ) karakterlerini içerir
  • 0-9 ile başlamıyor
Alan yolunun maksimum boyutu 1500 bayt
Bir alan değerinin maksimum boyutu 1 MiB - 89 bayt (1.048.487 bayt)
Bir harita veya dizideki maksimum alan derinliği 20

Yazılar ve işlemler

sınır Detaylar
Veritabanı başına saniyede maksimum yazma 10.000 (saniyede 10 MiB'a kadar)*. Bu sınır gelecekte kaldırılacaktır, erken erişim için desteğe başvurun.
Maksimum API istek boyutu 10 MiB
Bir Commit işlemine geçirilebilecek veya bir işlemde gerçekleştirilebilecek maksimum yazma sayısı 500
Bir Commit işleminde veya bir işlemde tek bir belge üzerinde gerçekleştirilebilecek maksimum alan dönüşümü sayısı 500
Bir işlem için zaman sınırı 60 saniyelik boşta kalma süresi ile 270 saniye

Yumuşak sınırlar

Cloud Firestore, aşağıdaki eşikleri aşmanızı engellemez, ancak bunu yapmanız performansı etkiler.

Yumuşak sınır Detaylar
Bir belgeye maksimum sürdürülebilir yazma hızı

saniyede 1

Saniyede birden fazla yazma hızının sürdürülmesi gecikmeyi artırır ve çekişme hatalarına neden olur. Bu zor bir sınır değildir ve kısa aralıklarla sınırı aşabilirsiniz.

Dizine alınmış bir alanda belgelerin sıralı değerler içerdiği bir koleksiyona maksimum yazma hızı saniyede 500

Gerçek zamanlı güncellemeler

Yumuşak sınır Detaylar
Veritabanı başına mobil/web istemcileri için maksimum eşzamanlı bağlantı

1.000.000

Cloud Firestore, bu yumuşak sınırı aşmanızı engellemez ancak bunu yapmak gecikmeyi ve hata oranını büyük ölçüde etkiler.

dizinler

Tek alanlı dizinler ve bileşik dizinler için aşağıdaki sınırlar geçerlidir:

sınır Detaylar
Bir veritabanı için maksimum bileşik dizin sayısı 200
Bir veritabanı için maksimum tek alanlı yapılandırma sayısı

200

Toplam 200 alan düzeyinde yapılandırmaya izin verilir. Bir alan konfigürasyonu, aynı alan için birden fazla konfigürasyon içerebilir. Örneğin, tek alanlı dizin oluşturma muafiyeti ve aynı alandaki bir TTL ilkesi, sınıra doğru bir alan yapılandırması olarak sayılır.

Her belge için maksimum dizin girişi sayısı

40.000

Dizin girişlerinin sayısı, bir belge için aşağıdakilerin toplamıdır:

  • Tek alanlı dizin girişlerinin sayısı
  • Bileşik dizin girişlerinin sayısı

Cloud Firestore'un bir belgeyi ve bir dizi dizini dizin girişlerine nasıl dönüştürdüğünü görmek için bu dizin girişi sayısı örneğine bakın.

Bileşik dizindeki maksimum alan sayısı 100
Bir dizin girişinin maksimum boyutu

7.5 KiB

Cloud Firestore'un dizin girişi boyutunu nasıl hesapladığını görmek için bkz. dizin girişi boyutu .

Bir belgenin dizin girişlerinin boyutlarının maksimum toplamı

8 MiB

Toplam boyut, bir belge için aşağıdakilerin toplamıdır:

  • Bir belgenin tek alanlı dizin girişlerinin boyutunun toplamı
  • Bir belgenin bileşik dizin girişlerinin boyutunun toplamı
  • Dizine alınmış alan değerinin maksimum boyutu

    1500 bayt

    1500 baytın üzerindeki alan değerleri kısaltılır. Kesilmiş alan değerlerini içeren sorgular tutarsız sonuçlar döndürebilir.

    Yaşama Süresi (TTL)

    sınır Detaylar
    Bir veritabanı için maksimum tek alanlı yapılandırma sayısı

    200

    Toplam 200 alan düzeyinde yapılandırmaya izin verilir. Bir alan konfigürasyonu, aynı alan için birden fazla konfigürasyon içerebilir. Örneğin, tek alanlı dizin oluşturma muafiyeti ve aynı alandaki bir TTL ilkesi, sınıra doğru bir alan yapılandırması olarak sayılır.

    İthalat ihracat

    Yönetilen ithalat ve ihracat işlemleri için aşağıdaki sınırlar geçerlidir:

    sınır Detaylar
    Dakikada izin verilen bir proje için hem dışa aktarma hem de içe aktarma isteklerinin maksimum toplam sayısı 20
    Maksimum eşzamanlı ihracat ve ithalat sayısı 50
    Dışa aktarma ve içe aktarma istekleri için maksimum koleksiyon kimliği filtresi sayısı 100

    Güvenlik kuralları

    sınır Detaylar
    İstek başına maksimum exists() , get() ve getAfter() çağrı sayısı
    • Tek belge istekleri ve sorgu istekleri için 10.
    • Çoklu belge okumaları, işlemler ve toplu yazma işlemleri için 20. Her işlem için önceki 10 sınırı da geçerlidir.

      Örneğin, 3 yazma işlemiyle toplu bir yazma isteği oluşturduğunuzu ve güvenlik kurallarınızın her bir yazmayı doğrulamak için 2 belge erişim çağrısı kullandığını hayal edin. Bu durumda, her yazma 10 erişim çağrısından 2'sini kullanır ve toplu yazma isteği, 20 erişim çağrısından 6'sını kullanır.

    Her iki sınırın da aşılması, izin reddedildi hatasıyla sonuçlanır.

    Bazı belge erişim aramaları önbelleğe alınabilir ve önbelleğe alınan aramalar sınırlara dahil edilmez.

    Maksimum iç içe match ifadesi derinliği 10
    Bir dizi iç içe match ifadesi içinde izin verilen yol segmentlerinde maksimum yol uzunluğu 100
    Bir dizi iç içe match ifadesi içinde izin verilen maksimum yol yakalama değişkeni sayısı 20
    Maksimum işlev çağrısı derinliği 20
    Maksimum işlev bağımsız değişkeni sayısı 7
    İşlev başına maksimum let değişken bağlaması sayısı 10
    Maksimum özyinelemeli veya döngüsel işlev çağrısı sayısı 0 (izin verilmez)
    İstek başına değerlendirilen maksimum ifade sayısı 1.000
    Bir kural kümesinin maksimum boyutu Kural kümeleri iki boyut sınırına uymalıdır:
    • Firebase konsolundan veya firebase deploy yayınlanan kural kümesi metin kaynağının boyutunda 256 KB'lik bir sınır.
    • Firebase kaynağı işlediğinde ve arka uçta aktif hale getirdiğinde ortaya çıkan, derlenmiş kural kümesi boyutunda 250 KB'lik bir sınır.

    Harcamaları yönet

    Faturanızda beklenmeyen ücretlerin önlenmesine yardımcı olmak için aylık bütçeler ve uyarılar ayarlayın.

    Aylık bir bütçe belirleyin

    Cloud Firestore maliyetlerinizi takip etmek için Google Cloud Console'da aylık bir bütçe oluşturun. Bütçeler kullanımınızı sınırlamaz, ancak ay için planlanan maliyetlerinize yaklaştığınızda veya bunları aştığınızda sizi bilgilendirmek için uyarılar ayarlayabilirsiniz.

    Bütçe belirlemek için Google Cloud Console'daki Faturalandırma bölümüne gidin ve Cloud Billing hesabınız için bir bütçe oluşturun. Aylık bütçenizin farklı yüzdelerinde bildirim göndermek için varsayılan uyarı ayarlarını kullanabilir veya uyarıları değiştirebilirsiniz.

    Bütçeleri ve bütçe uyarılarını ayarlama hakkında daha fazla bilgi edinin.

    Günlük harcama limiti belirleyin

    Cloud Firestore kullanımınızı sınırlamak için App Engine aracılığıyla bir günlük harcama sınırı belirleyin. App Engine, Cloud Firestore dahil olmak üzere App Engine ile ilişkili kaynaklar için günlük harcama sınırı belirlemenize olanak tanır. App Engine sınırı, diğer Firebase ürünleri için geçerli değildir.