Kullanım ve sınırlar

Bulut Firestore sınırlarını anlamak ve görmek için bu kılavuzu kullanın Bulut Firestore Fiyatlandırma için dikkat şeyler dahil Bulut Firestore maliyetlerinin tam, ayrıntılı açıklama için.

Kullanımınızı izleyin

Cloud Firestore kullanımını izlemek için Bulut Firestore açmak Kullanımı sekmesini Firebase konsolunda. 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. App Engine Kotalar Google Bulut Konsolu sayfa Bulut Firestore kullanım ve kota bilgileri izler.

Ücretsiz kota

Cloud Firestore, ücretsiz olarak başlamanıza olanak tanıyan ücretsiz kota sunar. Ücretsiz kota miktarları aşağıda listelenmiştir. Eğer daha fazla kota gerekiyorsa, gereken Cloud Platform projesi için fatura etkinleştirmek .

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 ( / )
  • Sadece (tek bir süre oluşamaz . ) Ya da çift nokta ( .. )
  • Düzenli ifade eşleşmesi olamaz __.*__
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 ( / )
  • Sadece (tek bir süre oluşamaz . ) Ya da çift nokta ( .. )
  • Düzenli ifade eşleşmesi olamaz __.*__
  • Bir Firestore veritabanına Datastore varlıklarını içe aktarırsanız, sayısal varlık kimlikleri olarak maruz kalan __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ı ü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
  • Tek bir dönemle alan adlarını ayırmak gerekir ( . )
  • Aksi bir FieldPath nesnesi olarak geçmiş olması gerekir, yoldaki tüm alan adları basit bir dize olarak aktarılabilir ( örn: JavaScript FieldPath )
Basit bir alan adı, aşağıdakilerin hepsinin doğru olduğu bir addır:
  • Sadece karakterler içerir az , AZ , 0-9 ve alt çizgi ( _ )
  • İle başlamıyor 0-9
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)
Maksimum API istek boyutu 10 MiB
Bir geçirilebilir yazma maksimum sayısı Commit işlemi veya bir işlemde gerçekleştirilen 500
Bir tek belge üzerinde gerçekleştirilebilir alan dönüşümlerin maksimum sayısı Commit işlemi veya bir işlemde 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

Aşağıdaki sınırlar için geçerli tek alan endeksler ve kompozit endekslerinin :

sınır Detaylar
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ı

Bulut Firestore bir belge ve dizin girişleri içine endeksler bir dizi döner işlediğini görmek için bkz bu endeks giriş sayımı örneği .

Bir dizin girişinin maksimum boyutu

7.5 KiB

Bulut Firestore endeksi giriş boyutunu nasıl hesapladığını görmek için bkz indeks girişi boyutunu .

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.

    İthalat ihracat

    Aşağıdaki sınırlar uygulanır yönetilen ithalat ve ihracat işlemleri :

    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
    Maksimum sayısı exists() , get() ve getAfter() istek başına çağrıları
    • 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 deyimi derinliği 10
    İç içe bir dizi içinde izin yolu segmentlerinde Maksimum yol uzunluğu, match ifadeleri 100
    Yol yakalama değişkenlerin maksimum sayısı iç içe bir dizi içinde izin match ifadeleri 20
    Maksimum işlev çağrısı derinliği 20
    Maksimum işlev bağımsız değişkeni sayısı 7
    Maksimum sayıda let işlevi başına değişken bağlamaları 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 kullanılarak veya CLI yayınlanan kural takımı metin kaynağının boyutuna 256 KB sınırı firebase deploy .
    • 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.

    Bir bütçe ayarlamak üzere gidin Fatura Google Bulut Konsolu bölümü ve Cloud Fatura hesap için 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.

    Hakkında daha fazla bilgi bütçeleri ve bütçe uyarıları kurma .

    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 bir ayarlamanızı sağlar günlük harcama limiti Bulut Firestore dahil App Engine ilişkili kaynaklar üzerinde. App Engine sınırı, diğer Firebase ürünleri için geçerli değildir.