Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

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ı bir 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 kontrol panelini kullanın.

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

Bir Firebase projesi oluşturduğunuzda, aynı zamanda bir Google Cloud projesi de oluşturmuş olursunuz. Google Cloud Console'daki Cloud Firestore API Kotaları ve App Engine Kotaları sayfaları, 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 saatine göre gece yarısı civarında sıfırlanır.

ücretsiz katman Kota
Depolanmış veri 1 GB
Belge okur günde 50.000
Belge yazar günde 20.000
Belge silme 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 kesin 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
  • 1.500 bayttan uzun olmamalıdır
  • Eğik çizgi ( / ) içeremez
  • Yalnızca tek 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
  • 1.500 bayttan uzun olmamalıdır
  • Eğik çizgi ( / ) içeremez
  • Yalnızca tek 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
Belge adı için maksimum boyut 6 KiB
Bir belge için maksimum boyut 1 MiB (1.048.576 bayt)
Alan adlarındaki kısıtlamalar Geçerli UTF-8 karakterleri olmalıdır
Bir alan adının maksimum boyutu 1.500 bayt
Alan yollarındaki kısıtlamalar
  • Alan adlarını tek noktayla ( . ) ayırmalı
  • Yoldaki tüm alan adları basit olduğunda bir dize olarak iletilebilir, aksi takdirde bir FieldPath nesnesi ( örn. JavaScript FieldPath ) olarak iletilmelidir.
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
Bir alan yolunun maksimum boyutu 1.500 bayt
Bir alan değerinin maksimum boyutu 1 MiB - 89 bayt (1.048.487 bayt)
Bir harita veya dizideki maksimum alan derinliği 20

Yazmalar ve işlemler

Bu sınırlara ek olarak, ölçeğe göre tasarlamaya yönelik en iyi uygulamaları da görmelisiniz.

sınır Detaylar
Maksimum API istek boyutu 10 MiB
Bir Commit işlemine aktarılabilen veya bir işlemde gerçekleştirilebilen 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 saniye boşta sona erme süresi ile 270 saniye

Esnek sınırlar

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

Esnek limit Detaylar
Belgelerin dizine alınmış bir alanda sıralı değerler içerdiği bir koleksiyona maksimum yazma hızı saniyede 500

indeksler

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

sınır Detaylar
Bir veritabanı için maksimum bileşik dizin sayısı

200

Bu sınıra bir artış talep etmek için destek ekibiyle iletişime geçebilirsiniz .

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ı bir 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 nasıl dizin girişlerine 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 dizin girişi boyutu bölümüne bakın.

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ı
  • Dizinlenmiş bir alan değerinin maksimum boyutu

    1500 bayt

    1500 baytın üzerindeki alan değerleri kesilir. Kesilmiş alan değerleri içeren sorgular tutarsız sonuçlar verebilir.

    Yaşam 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ı bir 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 içe aktarma ve dışa aktarma işlemleri için aşağıdaki sınırlar geçerlidir:

    sınır Detaylar
    Bir proje için dakikada izin verilen 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 en fazla escape( exists() , get() ve getAfter() çağrısı sayısı
    • Tek belge istekleri ve sorgu istekleri için 10.
    • Çoklu belge okumaları, işlemler ve toplu yazmalar için 20. Önceki 10 sınırı da her işlem için geçerlidir.

      Örneğin, 3 yazma işlemi içeren toplu bir yazma isteği oluşturduğunuzu ve güvenlik kurallarınızın her 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 aşılması, izin reddedildi hatasıyla sonuçlanır.

    Bazı belge erişim çağrıları önbelleğe alınabilir ve önbelleğe alınan çağrılar limitlere dahil edilmez.

    Maksimum iç içe match bildirimi derinliği 10
    Bir dizi iç içe geçmiş match ifadesi içinde izin verilen, yol segmentlerinde maksimum yol uzunluğu 100
    Bir dizi iç içe geçmiş 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ğlama 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 CLI'den yayınlanan kural kümesi metin kaynağının boyutuna ilişkin 256 KB'lik bir sınır firebase deploy .
    • Firebase kaynağı işleyip arka uçta etkin hale getirdiğinde ortaya çıkan, derlenmiş kural kümesinin boyutunda 250 KB'lik bir sınır.

    Harcamaları yönet

    Faturanızda beklenmeyen masraflardan kaçınmanıza 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 bilgilendirmesi için uyarılar ayarlayabilirsiniz.

    Bütçe belirlemek için Google Cloud Console'daki Faturalandırma bölümüne gidin ve Cloud Faturalandırma hesabınız için bir bütçe oluşturun. Aylık bütçenizin farklı yüzdelerinde bildirimler 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 bir harcama sınırı belirlemenize olanak tanır. App Engine sınırı, diğer Firebase ürünleri için geçerli değildir.