Yalnızca Cloud Firestore Enterprise sürümü için geçerlidir. |
Bu sayfada, en sık karşılaşılan senaryolardan bazılarında faturalandırma birimlerinin nasıl hesaplandığına dair örnekler yer almaktadır. Her sorgunun, sorgu planı, verilerin şekli ve kullanılabilir dizinler gibi faktörlere bağlı olarak işlenen veriler açısından farklılık gösterebileceğini unutmayın.
Belirli sorgularınızın maliyetini ve performansını daha iyi anlamak için Sorgu Açıklama özelliğini kullanmanızı öneririz.
Okuma işlemleri
Çoğu okuma işlemi, belirli bir dokümanın nokta okumasını yapmayı veya bir tanımlayıcıya göre bir veri aralığını taramayı içerir. Okuma işlemleri, okuma birimlerini tüketir. Okuma birimleri 4 KiB'lik dilimler halinde hesaplanır. Aşağıdaki örneklere bakın.
Nokta okuma işlemleri
Puan okumaları için örnek faturalandırma:
- 1 KiB'lik tek bir dokümanın nokta okuması. Tüketim: 1 okuma birimi
- 4 KiB'lik tek bir dokümanın nokta okuması. Tüketim: 1 okuma birimi
- 1 MiB boyutundaki tek bir dokümanın nokta okuması. Tüketir: 256 okuma birimi
- Her biri 1 KiB olan 100 dokümanın okunması. Tüketim: 100 okuma birimi
Tarama
Aşağıdaki örneklerde, dokümanları tarayan veya dizin girişlerini tarayan senaryolar yer almaktadır.
Dokümanları Tarama
- Her biri 1 KiB olan 100 belgeyi tarayan sorgu. Tüketim: 25 okuma birimi
Tarama dizinleri
Bayt cinsinden tarama maliyeti, taranan öğenin doküman veya dizin olmasına bakılmaksızın aynıdır. Ancak dizin girişleri genellikle daha küçüktür. Bu nedenle, genellikle verileri taramanın daha uygun maliyetli bir yolunu sunabilirler.
- Her biri 1 KiB olan 100 dizin girişini tarayan sorgu. Tüketir: 25 okuma birimi.
- Her biri 128 baytlık 100 dizin girişini tarayan sorgu. Tüketim: 4 okuma birimi.
Minimum belge veya dizin girişi boyutu
Bazı durumlarda, bir sorguyu karşılamak için doküman veya dizin girişinin içeriğini okumak gerekli olmayabilir. Bu, bir koleksiyondaki toplam doküman sayısını hesaplama gibi basit sayı sorgularını içerir. Bu durumlarda, taranan her öğe için minimum 32 bayt maliyet uygulanır.
- Bir koleksiyondaki doküman sayısını hesaplayın. Sorgu, koleksiyondaki 1.000 öğeyi tarar. Tüketim: 8 okuma birimi.
Tarama ve nokta okumalarının kombinasyonu
Birçok sorgu, bir işlemi karşılamak için tarama ve nokta okuma kombinasyonu gerçekleştirir.
- Her biri 256 bayt olan 128 dizin girişini tarayan ve her biri 4 KiB olan 128 dokümanın nokta okumasını gerçekleştiren sorgu. 136 okuma birimi tüketir. Bu birimler şunlardan oluşur:
- Nokta okumaları için 128 okuma birimi
- Dizin taramaları için 8 okuma birimi
Sorgu Açıklaması
Query Explain, veritabanının sorgularınızı nasıl yürüttüğünü anlamanıza yardımcı olur. Sağlanan ayrıntılar, sorgularınızı optimize etmenize yardımcı olabilir.
Sorgu Açıklama'yı kullanırken aşağıdaki maliyetler geçerlidir:
- Sorguyu yürüten Query Explain: Sorgu maliyeti uygulanır.
- Yalnızca planı kullanarak sorguyu açıklama. Tüketim: 1 okuma birimi (sorgunun minimum maliyeti)
Yazma işlemleri
Yazma işlemleri (oluşturma, güncelleme ve silme) işlem sırasında oluşturulan, değiştirilen veya silinen dokümanların ve dizinlerin boyutuna göre ücretlendirilir. Yazma işlemleri, yazma birimlerini tüketir. Yazma birimleri 1 KiB'lik dilimler halinde hesaplanır.
Doküman kimliğine göre güncelleme gibi basit yazma işlemleri yalnızca yazma maliyetine neden olur. İşlemin karşılanması için sorgu gerektiren yazma işlemleri, sorguyla ilişkili okuma maliyetlerini de beraberinde getirir.
Aşağıdaki örneklere bakın.
Oluşturur
- Dizin içermeyen 10 KiB boyutunda yeni bir doküman oluşturun. Tüketir: 10 yazma birimi
- Koleksiyonda 256 baytlık 1 dizin girişi içeren 1 KiB'lik bir doküman oluşturun. Tüketir: 2 yazma birimi
Güncellemeler
- 10 KiB boyutundaki bir dokümanı doküman kimliğine göre bulun ve koleksiyonda dizin olmadan güncelleyin. Tüketir: 10 yazma birimi
- Belge kimliğine göre 1 KiB boyutunda bir belge bulun ve 1 alanı 256 baytlık 1 dizin girişiyle güncelleyin. Tüketim: 3 yazma birimi. Not: Bu durumda bir dizin girişinin güncellenmesi 2 yazma birimi kullanır. Biri dizin girişini silmek, diğeri ise yeniden oluşturmak için.
- Belge kimliğine göre 1 KiB'lik bir belgeyi bulun ve hiçbir şeyi güncellemeyin (değişiklik yok). Tüketir: 1 yazma birimi (minimum yazma maliyetleri)
- Bir koleksiyondaki 1 KB'lık tüm dokümanları sorgulayın. Bu işlemde 1.000 doküman taranır ve koleksiyonda dizin içermeyen 256 baytlık yeni bir alan eklenir: 1.000 okuma birimi ve 1.000 yazma birimi.
Silme işlemleri
- Koleksiyonda 1 dizini olan 1 KB'lık bir dokümanı silme Tüketir: 2 yazma birimi
- Koleksiyonda dizinleri olmayan 1 KiB'lik bir dokümanı silme Tüketir: 1 yazma birimi
Dizin derlemeleri
Dizin oluşturma işlemleri, oluşturma işlemi sırasında oluşturulan veya değiştirilen dizin girişleri için ücretlendirilir. Bu maliyetler, bir dizin tanımı eklendiğinde veya kaldırıldığında ortaya çıkar. Dizin girişleri, 1 KiB başına 1 yazma birimi maliyeti oluşturan yazma işlemleriyle aynı şekilde faturalandırılır.
- 500 doküman içeren bir koleksiyon için yeni bir dizin oluşturun. Oluşturulan dizin girişlerinin her biri 1 KiB'tır. 500 yazma birimi tüketir.
- 500 belge içeren bir koleksiyonun mevcut dizinini silme: Silinen dizin girişlerinin her biri 1 KiB'tır. 500 yazma birimi tüketir.