Cloud Firestore için en iyi uygulamalar

Cloud Firestore kullanan bir uygulama oluştururken burada listelenen en iyi uygulamaları hızlı bir referans olarak kullanın.

Veritabanı konumu

Veritabanı örneğinizi oluştururken kullanıcılarınıza ve bilgi işlem kaynaklarınıza en yakın veritabanı konumunu seçin. Uzak ağ atlamaları daha fazla hataya neden olur ve sorgu gecikmesini artırır.

Uygulamanızın kullanılabilirliğini ve dayanıklılığını en üst düzeye çıkarmak için çok bölgeli bir konum seçin ve kritik bilgi işlem kaynaklarını en az iki bölgeye yerleştirin.

Daha düşük maliyetler, uygulamanız gecikmeye duyarlıysa daha düşük yazma gecikmesi veya diğer GCP kaynaklarıyla birlikte konumlandırma için bir bölgesel konum seçin.

Doküman kimlikleri

• . ve .. doküman kimliklerinden kaçının.
• Doküman kimliklerinde / eğik çizgi kullanmaktan kaçının.

• Aşağıdakiler gibi tekdüze artan doküman kimlikleri kullanmayın:

  • Customer1, Customer2, Customer3, ...
  • Product 1, Product 2, Product 3, ...

  Bu tür sıralı kimlikler, gecikmeyi etkileyen hotspot'lara neden olabilir.

Alan adları

• Aşağıdaki karakterler ek kod dışına alma işlemi gerektirdiğinden alan adlarında bu karakterleri kullanmayın:

  • . nokta
  • [ sol köşeli ayraç
  • ] sağ köşeli ayraç
  • * yıldız işareti
  • ` vurgu işareti

Dizinler

Yazma gecikmesini azaltma

Yazma gecikmesine en büyük katkıyı dizin yayılımı yapar. Dizin yayılımını azaltmak için en iyi uygulamalar şunlardır:

• Koleksiyon düzeyinde dizin muafiyetleri ayarlayın. Varsayılan olarak Azalan ve Dizi dizine ekleme'yi devre dışı bırakmak kolaydır. Kullanılmayan dizine eklenmiş değerlerin kaldırılması depolama maliyetlerini de düşürür.

• Bir işlemdeki doküman sayısını azaltın. Çok sayıda belge yazmak için atomik toplu yazıcı yerine toplu yazıcı kullanmayı düşünebilirsiniz.

Dizin muafiyetleri

Çoğu uygulamada, dizinlerinizi yönetmek için otomatik dizine eklemenin yanı sıra hata mesajı bağlantılarını da kullanabilirsiniz. Ancak aşağıdaki durumlarda tek alan muafiyetleri eklemek isteyebilirsiniz:

Okuma ve yazma işlemleri

• Bir uygulamanın tek bir belgeyi güncelleyebileceği tam maksimum hız, iş yüküne büyük ölçüde bağlıdır. Daha fazla bilgi için Tek bir belgede yapılan güncellemeler başlıklı makaleyi inceleyin.

• Mümkün olduğunda eşzamanlı aramalar yerine eşzamansız aramaları kullanın. Eşzamansız aramalar, gecikme etkisini en aza indirir. Örneğin, bir yanıt oluşturmadan önce doküman aramasının sonucuna ve sorgu sonuçlarına ihtiyaç duyan bir uygulamayı ele alalım. Arama ve sorgu arasında veri bağımlılığı yoksa sorguyu başlatmadan önce aramanın tamamlanmasını eşzamanlı olarak beklemenize gerek yoktur.

• Ofset kullanmayın. Bunun yerine imleçleri kullanın. Yalnızca bir ofset kullanmak, atlanan dokümanların uygulamanıza döndürülmesini önler ancak bu dokümanlar yine de dahili olarak alınır. Atlanan belgeler, sorgunun gecikme süresini etkiler ve uygulamanız, bu belgeleri almak için gereken okuma işlemleri için faturalandırılır.

İşlem yeniden denemeleri

Cloud Firestore SDK'ları ve istemci kitaplıkları, geçici hatalarla başa çıkmak için başarısız olan işlemleri otomatik olarak yeniden dener. Uygulamanız, Cloud Firestore'ya bir SDK aracılığıyla değil de doğrudan REST veya RPC API'leri üzerinden erişiyorsa güvenilirliği artırmak için işlem yeniden denemelerini uygulamalıdır.

Gerçek zamanlı güncellemeler

Gerçek zamanlı güncellemelerle ilgili en iyi uygulamalar için Büyük ölçekte gerçek zamanlı sorguları anlama başlıklı makaleyi inceleyin.

Ölçeğe göre tasarım

Aşağıdaki en iyi uygulamalar, çekişme sorunlarına yol açan durumlardan nasıl kaçınacağınızı açıklar.

Tek bir dokümanda yapılan güncellemeler

Uygulamanızı tasarlarken uygulamanızın tek belgeleri ne kadar hızlı güncellediğini göz önünde bulundurun. İş yükünüzün performansını karakterize etmenin en iyi yolu yük testi yapmaktır. Bir uygulamanın tek bir belgeyi güncelleyebileceği kesin maksimum hız, iş yüküne büyük ölçüde bağlıdır. Faktörler arasında yazma hızı, istekler arasındaki çekişme ve etkilenen dizinlerin sayısı yer alır.

Bir belge yazma işlemi, belgeyi ve ilişkili tüm dizinleri günceller ve Cloud Firestore yazma işlemini eşzamanlı olarak bir çoğunluk replikasına uygular. Yazma hızı yeterince yüksek olduğunda veritabanı çakışma, daha yüksek gecikme veya başka hatalarla karşılaşmaya başlar.

Dar bir belge aralığında yüksek okuma, yazma ve silme hızları

Sözlükbilimsel olarak birbirine yakın dokümanlara yüksek okuma veya yazma hızlarıyla erişmekten kaçının. Aksi takdirde uygulamanızda çakışma hataları oluşur. Bu sorun, hotspotting olarak bilinir ve uygulamanız aşağıdakilerden herhangi birini yaparsa hotspotting sorunu yaşayabilir:

• Çok yüksek bir hızda yeni dokümanlar oluşturur ve kendi tekdüze artan kimliklerini ayırır.

  Cloud Firestore, doküman kimliklerini dağıtma algoritması kullanarak ayırır. Otomatik belge kimliklerini kullanarak yeni belgeler oluşturursanız yazma işlemlerinde hotspotting ile karşılaşmazsınız.

• Az sayıda doküman içeren bir koleksiyonda yüksek hızda yeni dokümanlar oluşturulması

• Zaman damgası gibi tekdüze artan bir alanla çok yüksek hızda yeni dokümanlar oluşturur.

• Bir koleksiyondaki belgeleri yüksek hızda siler.

• Trafiği kademeli olarak artırmadan çok yüksek bir hızda veritabanına yazma işlemi gerçekleştiriliyor.

Silinen verilerin atlanmasını önleme

Yakın zamanda silinen verileri atlayan sorgulardan kaçının. Erken sorgu sonuçları yakın zamanda silinmişse bir sorgunun çok sayıda dizin girişini atlaması gerekebilir.

Çok sayıda silinmiş veriyi atlamak zorunda kalabilecek bir iş yükü örneği, sıraya alınmış en eski iş öğelerini bulmaya çalışan bir iş yüküdür. Sorgu şu şekilde görünebilir:

docs = db.collection('WorkItems').order_by('created').limit(100)
delete_batch = db.batch()
for doc in docs.stream():
  finish_work(doc)
  delete_batch.delete(doc.reference)
delete_batch.commit()

Bu sorgu her çalıştırıldığında, yakın zamanda silinen belgelerdeki created alanı için dizin girişleri taranır. Bu durum sorguları yavaşlatır.

Performansı artırmak için start_at yöntemini kullanarak başlamak için en iyi yeri bulun. Örneğin:

completed_items = db.collection('CompletionStats').document('all stats').get()
docs = db.collection('WorkItems').start_at(
    {'created': completed_items.get('last_completed')}).order_by(
        'created').limit(100)
delete_batch = db.batch()
last_completed = None
for doc in docs.stream():
  finish_work(doc)
  delete_batch.delete(doc.reference)
  last_completed = doc.get('created')

if last_completed:
  delete_batch.update(completed_items.reference,
                      {'last_completed': last_completed})
  delete_batch.commit()

NOT: Yukarıdaki örnekte, yüksek yazma hızları için bir anti-pattern olan tekdüze şekilde artan bir alan kullanılmaktadır.

Trafiği artırma

Cloud Firestore'ın dokümanları artan trafiğe hazırlaması için yeterli süre tanıdığınızdan emin olmak amacıyla yeni koleksiyonlara veya sözlükbilimsel olarak yakın dokümanlara yönelik trafiği kademeli olarak artırmanız gerekir. Yeni bir koleksiyona saniyede en fazla 500 işlemle başlamanızı ve ardından trafiği her 5 dakikada bir %50 artırmanızı öneririz. Yazma trafiğinizi de benzer şekilde artırabilirsiniz ancak Cloud Firestore Standart Sınırları göz önünde bulundurmanız gerekir. İşlemlerin anahtar aralığı boyunca nispeten eşit şekilde dağıtıldığından emin olun. Bu, "500/50/5" kuralı olarak adlandırılır.

Trafiği yeni bir koleksiyona taşıma

Uygulama trafiğini bir koleksiyondan diğerine taşıyorsanız kademeli olarak artırma özellikle önemlidir. Bu taşıma işlemini gerçekleştirmenin basit bir yolu, eski koleksiyondan okuma yapmak ve belge yoksa yeni koleksiyondan okuma yapmaktır. Ancak bu, yeni koleksiyondaki sözlükbilimsel olarak yakın belgelere gelen trafikte ani bir artışa neden olabilir. Cloud Firestore, özellikle az sayıda belge içerdiğinde yeni koleksiyonu artan trafiğe verimli bir şekilde hazırlayamayabilir.

Aynı koleksiyondaki birçok dokümanın doküman kimliklerini değiştirirseniz benzer bir sorun oluşabilir.

Trafiği yeni bir koleksiyona taşıma konusunda en iyi strateji, veri modelinize bağlıdır. Aşağıda, paralel okuma olarak bilinen örnek bir strateji verilmiştir. Bu stratejinin verileriniz için etkili olup olmadığını belirlemeniz gerekir. Ayrıca, taşıma sırasında paralel işlemlerin maliyet üzerindeki etkisi önemli bir husus olacaktır.

Paralel okuma

Trafiği yeni bir koleksiyona taşırken paralel okumaları uygulamak için önce eski koleksiyondan okuyun. Doküman eksikse yeni koleksiyondan okuyun. Olmayan dokümanların yüksek oranda okunması, hotspotting'e yol açabilir. Bu nedenle, yeni koleksiyona yükü kademeli olarak artırdığınızdan emin olun. Daha iyi bir strateji, eski dokümanı yeni koleksiyona kopyalayıp eski dokümanı silmektir. Cloud Firestore'nın yeni koleksiyona gelen trafiği işleyebildiğinden emin olmak için paralel okumaları kademeli olarak artırın.

Yeni bir koleksiyonda okuma veya yazma işlemlerini kademeli olarak artırmak için kullanıcı kimliğinin deterministik bir karma değerini kullanarak yeni doküman yazmaya çalışan kullanıcıların rastgele bir yüzdesini seçebilirsiniz. Kullanıcı kimliği karma değerinin sonucunun işleviniz veya kullanıcı davranışı tarafından çarpıtılmadığından emin olun.

Bu sırada, eski dokümanlardaki tüm verilerinizi yeni koleksiyona kopyalayan bir toplu iş çalıştırın. Toplu işiniz, etkin noktaları önlemek için sıralı doküman kimliklerine yazmaktan kaçınmalıdır. Toplu iş tamamlandığında yalnızca yeni koleksiyondan okuyabilirsiniz.

Bu stratejinin daha iyi bir versiyonu, kullanıcıları küçük gruplar halinde taşımaktır. Kullanıcı belgesine, ilgili kullanıcının taşıma durumunu izleyen bir alan ekleyin. Kullanıcı kimliğinin karma değerine göre taşınacak bir kullanıcı grubu seçin. Bu kullanıcı grubu için belgeleri taşımak üzere toplu bir iş kullanın ve taşıma işleminin ortasında olan kullanıcılar için paralel okuma kullanın.

Taşıma aşamasında hem eski hem de yeni öğelerin çift yazma işlemini yapmadığınız sürece kolayca geri dönemeyeceğinizi unutmayın. Bu, Cloud Firestore maliyetlerini artırır.

Gizlilik

• Hassas bilgileri Cloud projesi kimliğinde saklamayın. Cloud projesi kimliği, projenizin kullanım ömründen daha uzun süre saklanabilir.
• Veri uyumluluğu açısından en iyi uygulama olarak, hassas bilgileri doküman adlarında ve doküman alanı adlarında depolamamanızı öneririz.

Yetkisiz erişimi önleme

Cloud Firestore Security Rules ile veritabanınızda yetkisiz işlemlerin yapılmasını önleyin. Örneğin, kurallar kullanılarak kötü niyetli bir kullanıcının veritabanınızın tamamını tekrar tekrar indirmesi önlenebilir.

Cloud Firestore Security Rules kullanma hakkında daha fazla bilgi edinin.