Bu sayfada, yerel mod veritabanındaki verilere erişmek için kullanılabilecek farklı arayüzler açıklanmaktadır.
İşlem arayüzleri
Yerel mod, verilere erişmek için iki arayüzü destekler:
Ardışık düzen işlemleri
Cloud Firestore için daha yeni sorgu arayüzü. Ardışık düzen işlemleri, aşama tabanlı bir birleştirilebilir söz dizimini destekler. Bir işlemi, sırayla yürütülen bir dizi sıralı aşama tanımlayarak oluşturursunuz. Bu sayede, orijinal arayüzde (Temel işlemler) daha önce mümkün olmayan, toplama sonucuna göre filtreleme gibi karmaşık işlemler yapılabilir.
Ardışık düzen işlemleri yalnızca Firestore Enterprise sürümünde kullanılabilir ve önizleme lansman aşamasındadır.
Temel işlemler
Temel işlemler, Cloud Firestore için orijinal arayüzdür.
Temel işlemler, dokümanları almak için doküman veya koleksiyon referanslarında yöntem zincirleme söz dizimi (.where(), .orderBy(), .get()) kullanır.
Sorgu aşamalarının sıralaması ima edilir ve toplama desteği sınırlıdır.
Temel işlemler hem Enterprise hem de Standard sürümünde kullanılabilir ancak dizin varsayılanları sürümler arasında çok farklıdır. Ayrıntılar için sonraki bölüme bakın.
Sürümler arasındaki arayüz farkları
Enterprise sürümünde yerel mod desteğinin kullanıma sunulmasıyla hem Firestore Core hem de Pipeline işlemleri kullanılabilir. Enterprise sürümünde temel işlemleri kullanırken yeni dizin davranışı ve fiyatlandırma modeli, Standard sürümündeki kısıtlamaların çoğunu kaldırır.
| Özellik | Standart sürüm | Enterprise sürümü |
| Desteklenen işlemler | Firestore Core işlemleriyle sınırlıdır. | Firestore Core ve Pipeline işlemlerini, Firestore MongoDB uyumluluk işlemlerini destekler. |
| Dizine Ekleme Şartı | Tüm sorgular için dizin gerekir. | Sorgular için dizin gerekmez. |
| Dizin Oluşturma | Tek alanlar için otomatik dizinler oluşturulur. Bileşik dizinleri manuel olarak oluşturabilirsiniz. | Otomatik dizinler oluşturulmaz. Dizinlerin manuel olarak yönetilmesi gerekir. |
| Dizine Eklenen Alanlar | Daha önce mevcut değilse dizine eklenen alanlara otomatik olarak ek bir __name__ alanı eklenir. | __name__, dizine eklenen alanlara otomatik olarak eklenmez. Uygulamanız için önemliyse dizine eklenen alanlarda __name__ değerini açıkça belirtmeniz gerekir. |
| Sıralama Düzenini Normalleştirme | Sorgunun order by ifadesi, eşitsizlik alanları ve __name__ alanı sona eklenerek (zaten mevcut değilse) normalleştirilir. Bu, sonuçların, order by ifadesindeki diğer alanlardan bağımsız olarak benzersiz ve deterministik bir şekilde sıralanmasını sağlar. | Sıralama ölçütü normalleştirme yok. sort a ASC gibi bir sıralama düzeni yalnızca sonuçların a alanına göre sıralanmasını garanti eder. Cloud Firestore, sonuçları mümkün olan en verimli sırada döndürmek için mevcut dizinlerinizi kullanır. Bu nedenle, a sonuç kümesi arasında benzersiz değilse sonuçların sırası, dizin yapılandırmasına, yürütme stratejilerine vb. bağlı olarak sorgudan sorguya değişebilir. Sonuçların benzersiz ve deterministik bir şekilde sıralanmasını sağlamak için sıralama düzenine __name__ gibi benzersiz bir alan eklemeniz gerekir. |
| Sorgu Performansı ve Maliyeti | Sorgular, dizin gereksinimleri nedeniyle genellikle yüksek performanslıdır. | Dizin oluşturarak sorgu performansını ve maliyetleri optimize edin. Sorgu Açıklama ve Sorgu Analizleri'ni kullanarak eksik dizinleri belirleyebilirsiniz.
Dizin içermeyen sorgular, veri kümesi büyüdükçe performans açısından yetersiz ve maliyetli olabilir. Bu nedenle, izleme ve ince ayar yapılması gerekir. |
| Dizin Oluşturma Genel Gider Maliyeti | Dizinler otomatik olduğundan dizin yazma işlemleri için ücret alınmaz. | Dizin girişleri yazılırken, ilişkili bir belge yazıldığında yazma birimleri kullanılır (dizin girişi boyutunun 1 KiB'i başına 1 yazma birimi). Her alan için dizin girişi oluşturmayarak depolama maliyetlerinden tasarruf edersiniz. |
| Faturalandırma modeli (okuma/yazma/silme) | Belge okuma, yazma ve silme başına ücretlendirilir. | Okuma ve yazma (dilim) başına ücretlendirilir. Okumalar, Okuma Birimleri (4 KiB'lik dilimler) cinsinden ücretlendirilir. Yazma ve silme işlemleri Yazma Birimleri (1 KiB'lik dilimler) olarak birleştirilir. |
| Temel Fiyatlandırma (milyon başına)
Gösterilen fiyatlar us-central1 bölgesi içindir. |
Okuma: 100.000 belge başına 0,03 ABD doları (veya milyon başına 0,30 ABD doları).
Yazma: 100.000 belge başına 0,09 ABD doları (veya milyon başına 0,90 ABD doları). Silme: 100.000 belge başına 0,01 ABD doları (veya milyon başına 0,10 ABD doları) |
Okuma Birimleri: 1 milyon okuma birimi başına 0,05 ABD doları.
Yazma birimleri: 1 milyon yazma birimi başına 0,26 ABD doları. Belgeler 4 KiB'tan küçükse fiyatlar genellikle Standart Okuma maliyetine kıyasla daha düşüktür. |
| Anlık Güncellemeler
Gösterilen fiyatlar us-central1 bölgesi içindir. |
Anlık güncellemeler 100.000 belge başına 0,03 ABD doları karşılığında Okuma olarak faturalandırılır. | Anlık güncellemeler için yeni bir ayrı SKU (Anlık Güncelleme Birimleri) sunulmuştur. Bu SKU, 4 KiB'lik dilimler halinde ücretlendirilir. Anlık güncellemelerin maliyeti 1 milyon okuma birimi başına 0,30 ABD dolarıdır. |