Google is committed to advancing racial equity for Black communities. See how.
Bu sayfa, Cloud Translation API ile çevrilmiştir.
Switch to English

Kullanım ve sınırlar

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 Konsolu'ndaki Cloud Firestore Kullanımı sekmesini açın . Farklı dönemlerdeki kullanımınızı ölçmek için kontrol panelini kullanın.

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

Bir Firebase projesi oluşturduğunuzda, Google Cloud Platform'da da bir proje oluşturursunuz. Cloud Cloud Platform 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 Cloud Platform 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 GiB
Belge okur Günde 50.000
Belge yazıyor Günde 20.000
Belge silme Günde 20.000
Ağ çıkışı Ayda 10 GiB

Standart sınırlar

Aşağıdaki tablolar, Cloud Firestore kullanımınız için geçerli olan sınırları gösterir.

Koleksiyonlar, belgeler ve alanlar

limit ayrıntılar
Koleksiyon kimliklerindeki 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 bir noktadan ( . ) Veya çift noktadan ( .. ) oluşamaz
  • __.*__ normal ifadesiyle eşleşemez
Maksimum alt koleksiyon derinliği 100
Belge kimliklerindeki 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 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]+__
Bir 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ı tek bir nokta ( . ) İle ayrılmalıdır
  • Yoldaki tüm alan adları basit olduğunda bir dize olarak aktarılabilir, aksi takdirde bir FieldPath nesnesi olarak aktarılmalıdır ( örneğin JavaScript FieldPath )
Basit alan adı, aşağıdakilerin hepsinin doğru olduğu addır:
  • Yalnızca az , AZ , 0-9 karakterlerini ve alt çizgi ( _ ) içerir
  • 0-9 ile başlamaz
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

Yazılar ve işlemler

limit ayrıntılar
Maksimum API istek boyutu 10 MiB
Veritabanı başına saniyede maksimum yazma 10.000 (saniyede 10 MiB'ye kadar)
Bir belgeye maksimum sürekli yazma hızı

Saniyede 1

Yazma hızının saniyede bir kereden fazla sürdürülmesi gecikmeyi artırır ve çekişme hatalarına neden olur. Bu kesin bir sınır değildir ve kısa süreli patlamalarda sınırı aşabilirsiniz.

Belgelerin dizine alınmış bir alanda sıralı değerler içerdiği bir koleksiyona maksimum yazma hızı Saniyede 500
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 belgede 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 sona erme süresiyle 270 saniye

Gerçek zamanlı güncellemeler

limit ayrıntılar
Veritabanı başına mobil / web istemcileri için maksimum eşzamanlı bağlantı 1.000.000

endeksleri

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

limit ayrıntılar
Bir veritabanı için maksimum bileşik dizin sayısı 200
Bir veritabanı için maksimum tek alanlı dizin muafiyeti sayısı 200

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 .

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 boyutuna bakın .

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

8 MiB

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

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

    1500 bayt

    1500 baytı aşan alan değerleri kesilir. Kesilmiş alan değerlerini içeren sorgular tutarsız sonuçlar döndürebilir.

    İthalat ihracat

    Yönetilen içe ve dışa aktarma işlemleri için aşağıdaki sınırlar geçerlidir:

    limit ayrıntılar
    Dakikada izin verilen bir proje için hem dışa aktarma hem de içe aktarma taleplerinin 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ı

    limit ayrıntılar
    İ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. Önceki sınır olan 10, her işlem için de geçerlidir.

      Örneğin, 3 yazma işlemiyle 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.

    Bu sınırlardan birinin aşılması, izin verilmedi 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 geçmiş match bildirimi derinliği 10
    Yol segmentlerinde bir dizi iç içe match ifadesinde izin verilen 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ğ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 Verax kural kümeleri iki boyut sınırına uymalıdır:
    • firebase deploy konsolundan veya firebase deploy kullanılarak firebase deploy yayınlanan Verax kural firebase deploy metin kaynağının boyutunda 256 KB sınır.
    • Firebase Verax kaynağını işlediğinde ve arka uçta etkinleştirdiğinde ortaya çıkan derlenmiş kural kümesinin boyutunda 250 KB sınır.

    Harcamayı yönetin

    Faturanızda beklenmedik ücretlerden kaçınmaya 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 Cloud Platform 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 aştığınızda sizi bilgilendirmek için uyarılar ayarlayabilirsiniz.

    Bir bütçe belirlemek için Cloud Platform Console'daki Faturalandırma bölümüne gidin ve 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.

    Cloud Platform Console'da bütçe belirleme hakkında daha fazla bilgi edinin.

    Günlük harcama limiti belirleyin

    Cloud Firestore kullanımınızı sınırlamak için Google App Engine üzerinden günlük bir harcama sınırı ayarlayın. 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.