Cloud Firestore'daki dizin türleri

Dizinler, veritabanının performansında önemli bir faktördür. Bir kitaptaki konuları sayfa numaralarıyla eşleştiren kitabın dizini gibi, veri tabanı dizini de bir veri tabanındaki öğeleri veri tabanındaki konumlarıyla eşleştirir. Bir veritabanını sorgularken veritabanı, istediğiniz öğelerin konumlarını hızlıca belirlemek için bir dizin kullanabilir.

Bu sayfada, Cloud Firestore'ün kullandığı iki tür dizin (tek alanlı dizinler ve birleşik dizinler) açıklanmaktadır.

Dizin tanımı ve yapısı

Dizin, belirli bir belgenin alan listesinde tanımlanır ve her alan için karşılık gelen bir dizin modu bulunur.

Dizinler, dizin tanımında adı geçen her alan için bir giriş içerir. Dizin, dizin tabanlı sorguların olası sonuçları olan tüm dokümanları içerir. Bir belge, yalnızca dizinde kullanılan her alan için dizine eklenmiş bir değer kümesine sahipse dizin kapsamına alınır. Dizin tanımı, belgede değeri ayarlanmamış bir alanı ifade ediyorsa söz konusu belge dizinde görünmez. Bu durumda, doküman hiçbir zaman dizin tabanlı bir sorgunun sonucu olarak döndürülmez.

Kompozit dizin, dizin tanımında belirtilen sıraya göre alan değerlerine göre sıralanır.

Her sorgunun arkasında bir dizin

Bir sorgu için dizin yoksa çoğu veritabanı içeriklerini öğe öğe tarar. Bu, veritabanı büyüdükçe daha da yavaşlayan yavaş bir işlemdir. Cloud Firestore, tüm sorgular için dizinler kullanarak yüksek sorgu performansı sağlar. Sonuç olarak sorgu performansı, veritabanındaki öğe sayısına değil sonuç kümesinin boyutuna bağlıdır.

Daha az dizin yönetimi, daha fazla uygulama geliştirme

Cloud Firestore, dizin yönetimi için harcamanız gereken süreyi azaltan özellikler içerir. En temel sorgular için gereken dizinler sizin için otomatik olarak oluşturulur. Cloud Firestore, uygulamanızı kullanırken ve test ederken uygulamanızın ihtiyaç duyduğu ek dizinleri belirlemenize ve oluşturmanıza yardımcı olur.

Dizin türleri

Cloud Firestore iki tür dizin kullanır: tek alan ve birleşik. Tek alanlı ve birleşik dizinler, dizine eklenen alan sayısı dışında, bunları yönetme şekliniz açısından da farklılık gösterir.

Tek alanlı dizinler

Tek alan dizini, koleksiyondaki belirli bir alanı içeren tüm belgelerin sıralanmış bir eşlemesini depolar. Tek alanlı dizindeki her giriş, bir belgenin belirli bir alan için değerini ve veritabanındaki konumunu kaydeder. Cloud Firestore, birçok temel sorguyu gerçekleştirmek için bu dizinleri kullanır. Tek alan dizinlerini, veritabanınızın otomatik dizine ekleme ayarlarını ve dizin muafiyetlerini yapılandırarak yönetirsiniz.

Otomatik dizine ekleme

Varsayılan olarak Cloud Firestore, bir belgedeki her alan ve haritadaki her alt alan için tek alan dizinlerini otomatik olarak korur. Cloud Firestore tek alanlı dizinler için aşağıdaki varsayılan ayarları kullanır:

  • Cloud Firestore, dizi ve harita olmayan her alan için biri artan modda, diğeri azalan modda olmak üzere iki koleksiyon kapsamlı tek alan dizini tanımlar.

  • Cloud Firestore her harita alanı için aşağıdakileri oluşturur:

    • Her dizi ve harita olmayan alt alan için bir koleksiyon kapsamlı artan dizin.
    • Her dizi ve harita dışı alt alan için bir koleksiyon kapsamlı azalan dizin.
    • Her dizi alt alanı için bir koleksiyon kapsamlı dizi-içerdiği dizini.
    • Cloud Firestore her harita alt alanını yinelemeli olarak dizine ekler.

  • Cloud Firestore, bir belgedeki her dizi alanı için koleksiyon kapsamlı bir dizi-içerdiği dizini oluşturur ve korur.

  • Koleksiyon grubu kapsamına sahip tek alan dizinleri varsayılan olarak korunmaz.

Tek alanlı dizin muafiyetleri

Tek alan dizini muafiyeti oluşturarak bir alanı otomatik dizine ekleme ayarlarınızdan muaf tutabilirsiniz. Dizine ekleme muafiyeti, veritabanı genelindeki otomatik dizin ayarlarını geçersiz kılar. Muafiyetler, otomatik dizine ekleme ayarlarınızın devre dışı bırakacağı tek alan dizinlerini etkinleştirebilir veya otomatik dizine eklemenin etkinleştireceği tek alan dizinlerini devre dışı bırakabilir. Muafiyetlerin yararlı olabileceği durumlar için dizine eklemeyle ilgili en iyi uygulamalara göz atın.

Bir koleksiyon grubundaki tüm alanlara koleksiyon düzeyinde dizine ekleme muafiyeti eklemek için * alan yolu değerini kullanın. Örneğin, comments koleksiyon grubu için alan yolunu comments koleksiyon grubundaki tüm alanlarla eşleşecek şekilde * olarak ayarlayın ve koleksiyon grubundaki tüm alanların dizine eklenmesini devre dışı bırakın. Ardından, yalnızca sorgularınız için gerekli alanları dizine eklemek üzere muafiyetler ekleyebilirsiniz. Dizine eklenen alanların sayısını azaltmak depolama alanı maliyetlerini düşürür ve yazma performansını artırabilir.

Bir harita alanı için tek alan dizin muafiyeti oluşturursanız haritanın alt alanları bu ayarları devralır. Ancak belirli alt alanlar için tek alan dizine ekleme muafiyeti tanımlayabilirsiniz. Bir alt alan için muafiyeti silerseniz alt alan, üst alanın muafiyet ayarlarını (varsa) veya üst alan muafiyeti yoksa veritabanı genelindeki ayarları devralır.

Tek alan içeren dizin muafiyetleri oluşturmak ve yönetmek için Dizinleri yönetme başlıklı makaleyi inceleyin.

Birleşik dizinler

Bileşik dizin, dizine eklenecek alanların sıralı bir listesine göre bir koleksiyondaki tüm dokümanların sıralı eşlemesini depolar.

Cloud Firestore, tek alanlı dizinler tarafından desteklenmeyen sorguları desteklemek için birleşik dizinler kullanır.

Cloud Firestore, olası alan kombinasyonlarının çok sayıda olması nedeniyle tek alan dizinlerinde olduğu gibi bileşik dizinleri otomatik olarak oluşturmaz. Bunun yerine Cloud Firestore, uygulamanızı oluştururken gerekli karma dizinleri tanımlamanıza ve oluşturmanıza yardımcı olur.

Bir dizin tarafından desteklenmeyen bir sorgu yapmaya çalıştığınızda Cloud Firestore, eksik dizini oluşturmak için izleyebileceğiniz bir bağlantı içeren bir hata mesajı döndürür.

Karma dizinleri konsolu veya Firebase CLI'yi kullanarak manuel olarak da tanımlayıp yönetebilirsiniz. Karma dizin oluşturma ve yönetme hakkında daha fazla bilgi için Dizinleri yönetme başlıklı makaleyi inceleyin.

Dizin modları ve sorgu kapsamları

Tek alan ve bileşik dizinleri farklı şekilde yapılandırırsınız ancak her ikisi için de dizinlerinizin dizine ekleme modlarını ve sorgu kapsamlarını yapılandırmanız gerekir.

Dizin modları

Bir dizin tanımlarken her dizine eklenen alan için bir dizin modu seçersiniz. Her alanın dizin modu, o alanda belirli sorgu yan tümcelerini destekler. Aşağıdaki dizin modları arasından seçim yapabilirsiniz:

Dizin modu Açıklama
Artan Alanda <, <=, ==, >=, >, !=, in ve not-in sorgu yan tümcelerini destekler ve sonuçları bu alan değerine göre artan düzende sıralamayı destekler.
Azalan Alanda <, <=, ==, >=, >, !=, in ve not-in sorgu yan tümcelerini destekler ve sonuçları bu alan değerine göre azalan düzende sıralamayı destekler.
Dizi‑şunu içeriyor: Alanda array-contains ve array-contains-any sorgu yan tümcelerini destekler.
Vektör Alanda FindNearest sorgu yan tümcelerini destekler.

Sorgu kapsamları

Her dizin, bir koleksiyon veya koleksiyon grubu kapsamına alınır. Buna dizindeki sorgu kapsamı denir:

Koleksiyon kapsamı
Cloud Firestore, varsayılan olarak koleksiyon kapsamına sahip dizinler oluşturur. Bu dizinler, tek bir koleksiyondan sonuç döndüren sorguları destekler.

Koleksiyon grubu kapsamı
Koleksiyon grubu, aynı koleksiyon kimliğine sahip tüm koleksiyonları içerir. Bir koleksiyon grubundan filtrelenmiş veya sıralanmış sonuçlar döndüren bir koleksiyon grubu sorgusu çalıştırmak için koleksiyon grubu kapsamına sahip karşılık gelen bir dizin oluşturmanız gerekir.

Varsayılan sıralama ve __name__ alanı

Dizinler, belgeleri her alan için belirtilen dizin modlarına (artan veya azalan) göre sıralamanın yanı sıra her belgenin __name__ alanına göre de son bir sıralama uygular. __name__ alanına doküman yolunun tamamı ayarlanır. Bu, sonuç kümesinde aynı alan değerlerine sahip dokümanların doküman yoluna göre sıralandığı anlamına gelir.

Varsayılan olarak __name__ alanı, dizin tanımındaki son sıralanmış alanla aynı yönde sıralanır. Örneğin:

Toplama Dizine eklenen alanlar Sorgu kapsamı
şehirler adı, __name__ Toplama
şehirler state, __name__ Toplama
şehirler ülke, nüfus, __name__ Toplama

Sonuçları varsayılan olmayan __name__ yönüne göre sıralamak için bu dizini oluşturmanız gerekir.

Dizin özellikleri

Sorgunun en verimli şekilde yürütülmesine olanak tanıyan bir dizin aşağıdaki özelliklerle tanımlanır:

  • Eşitlik filtrelerinde kullanılan alanlar
  • Sıralama düzenlerinde kullanılan alanlar
  • Aralık ve eşitsizlik filtrelerinde kullanılan alanlar (sıralama ölçütlerine dahil edilmemiş olanlar)
  • Toplama işlemlerinde kullanılan alanlar (sıralama düzenlerine, aralık ve eşitsizlik filtrelerine dahil edilmemiş olanlar)

Cloud Firestore, sorguların sonuçlarını aşağıdaki gibi hesaplar:

  1. Sorgunun koleksiyonuna, filtre özelliklerine, filtre operatörlerine ve sıralama düzenlerine karşılık gelen dizini tanımlar.
  2. Taramanın başladığı dizin konumunu tanımlar. Başlangıç konumuna sorgunun eşitlik filtreleri eklenir ve ilk orderBy alanındaki aralık ve eşitsizlik filtreleriyle sonlandırılır.
  3. Tarama işlemi aşağıdakilerden birini yapana kadar dizini taramaya başlar ve tüm filtreleri karşılayan her dokümanı döndürür:
    • Filtre koşullarını karşılamayan bir belgeyle karşılaşır ve sonraki belgelerin hiçbir zaman filtre koşullarını tam olarak karşılamayacağını onaylar.
    • Dizin sonuna ulaşılır.
    • Sorgu tarafından istenen maksimum sonuç sayısını toplar.

Dizine ekleme örneği

Cloud Firestore, sizin için tek alan içeren dizinleri otomatik olarak oluşturarak uygulamanızın en temel veritabanı sorgularını hızlı bir şekilde desteklemesini sağlar. Tek alan dizini, alan değerlerine ve <, <=, ==, >=, > ve in karşılaştırıcılarına göre basit sorgular gerçekleştirmenize olanak tanır. Dizi alanları için array-contains ve array-contains-any sorguları gerçekleştirmenize olanak tanır.

Bunu açıklamak için aşağıdaki örnekleri dizin oluşturma açısından inceleyin. Aşağıdaki snippet, cities koleksiyonunda birkaç city dokümanı oluşturur ve her doküman için name, state, country, capital, population ve tags alanlarını ayarlar:

Web
var citiesRef = db.collection("cities");

citiesRef.doc("SF").set({
    name: "San Francisco", state: "CA", country: "USA",
    capital: false, population: 860000,
    regions: ["west_coast", "norcal"] });
citiesRef.doc("LA").set({
    name: "Los Angeles", state: "CA", country: "USA",
    capital: false, population: 3900000,
    regions: ["west_coast", "socal"] });
citiesRef.doc("DC").set({
    name: "Washington, D.C.", state: null, country: "USA",
    capital: true, population: 680000,
    regions: ["east_coast"] });
citiesRef.doc("TOK").set({
    name: "Tokyo", state: null, country: "Japan",
    capital: true, population: 9000000,
    regions: ["kanto", "honshu"] });
citiesRef.doc("BJ").set({
    name: "Beijing", state: null, country: "China",
    capital: true, population: 21500000,
    regions: ["jingjinji", "hebei"] });
test.firestore.js

Varsayılan otomatik dizine ekleme ayarları varsayarsak Cloud Firestore, dizi olmayan her alan için bir artan tek alanlı dizin, dizi olmayan her alan için bir azalan tek alanlı dizin ve dizi alanı için bir dizi içeren tek alanlı dizin günceller. Aşağıdaki tablodaki her satır, tek alan içeren bir dizindeki bir girişi temsil eder:

Toplama Dizine eklenen alan Sorgu kapsamı
şehirler adı Toplama
şehirler durum Toplama
şehirler ülke Toplama
şehirler büyük harf Toplama
şehirler nüfus Toplama
şehirler adı Toplama
şehirler durum Toplama
şehirler ülke Toplama
şehirler büyük harf Toplama
şehirler nüfus Toplama
şehirler array-contains bölge Toplama

Tek alanlı dizinler tarafından desteklenen sorgular

Otomatik olarak oluşturulan bu tek alan dizinlerini kullanarak aşağıdaki gibi basit sorgular çalıştırabilirsiniz:

Web
const stateQuery = citiesRef.where("state", "==", "CA");
const populationQuery = citiesRef.where("population", "<", 100000);
const nameQuery = citiesRef.where("name", ">=", "San Francisco");
test.firestore.js

in ve birleşik eşitlik (==) sorguları da oluşturabilirsiniz:

Web
citiesRef.where('country', 'in', ["USA", "Japan", "China"])

// Compound equality queries
citiesRef.where("state", "==", "CO").where("name", "==", "Denver")
citiesRef.where("country", "==", "USA")
         .where("capital", "==", false)
         .where("state", "==", "CA")
         .where("population", "==", 860000)

Aralık karşılaştırması (<, <=, > veya >=) kullanan bir karma sorgu çalıştırmanız veya farklı bir alana göre sıralamanız gerekiyorsa söz konusu sorgu için bir karma dizin oluşturmanız gerekir.

array-contains dizini, regions dizi alanını sorgulamanıza olanak tanır:

Web
citiesRef.where("regions", "array-contains", "west_coast")
// array-contains-any and array-contains use the same indexes
citiesRef.where("regions", "array-contains-any", ["west_coast", "east_coast"])

Bileşik dizinler tarafından desteklenen sorgular

Cloud Firestore, tek alanlı dizinler tarafından desteklenmeyen bileşik sorguları desteklemek için bileşik dizinler kullanır. Örneğin, aşağıdaki sorgular için birleşik bir dizin gerekir:

Web
citiesRef.where("country", "==", "USA").orderBy("population", "asc")
citiesRef.where("country", "==", "USA").where("population", "<", 3800000)
citiesRef.where("country", "==", "USA").where("population", ">", 690000)
// in and == clauses use the same index
citiesRef.where("country", "in", ["USA", "Japan", "China"])
         .where("population", ">", 690000)

Bu sorgular için aşağıdaki birleşik dizin gerekir. Sorgu, country alanı için eşitlik (== veya in) kullandığından bu alan için artan veya azalan dizin modunu kullanabilirsiniz. Eşitsizlik yan tümceleri varsayılan olarak eşitsizlik yan tümcesindeki alana göre artan bir sıralama düzeni uygular.

Toplama Dizine eklenen alanlar Sorgu kapsamı
şehirler (veya ) ülke, nüfus Toplama

Aynı sorguları azalan bir sıralama düzeniyle çalıştırmak için population için azalan yönde ek bir birleşik dizin oluşturmanız gerekir:

Web
citiesRef.where("country", "==", "USA").orderBy("population", "desc")

citiesRef.where("country", "==", "USA")
         .where("population", "<", 3800000)
         .orderBy("population", "desc")

citiesRef.where("country", "==", "USA")
         .where("population", ">", 690000)
         .orderBy("population", "desc")

citiesRef.where("country", "in", ["USA", "Japan", "China"])
         .where("population", ">", 690000)
         .orderBy("population", "desc")
Toplama Dizine eklenen alanlar Sorgu kapsamı
şehirler ülke, nüfus Toplama
cities country, population Toplama

Dizin birleştirme nedeniyle performans kaybı yaşamamak için bir array-contains veya array-contains-any sorgusunu ek yan tümcelerle birleştirmek üzere karma bir dizin oluşturmanızı öneririz:

Web
citiesRef.where("regions", "array-contains", "east_coast")
         .where("capital", "==", true)

// array-contains-any and array-contains use the same index
citiesRef.where("regions", "array-contains-any", ["west_coast", "east_coast"])
         .where("capital", "==", true)
Toplama Dizine eklenen alanlar Sorgu kapsamı
şehirler array-contains etiketleri, büyük (veya ) Toplama

Koleksiyon grubu dizinleri tarafından desteklenen sorgular

Koleksiyon grubu kapsamlı bir dizini göstermek için city dokümanlarından bazılarına landmarks alt koleksiyonu ekleyin:

Web
var citiesRef = db.collection("cities");

citiesRef.doc("SF").collection("landmarks").doc().set({
    name: "Golden Gate Bridge",
    category : "bridge" });
citiesRef.doc("SF").collection("landmarks").doc().set({
    name: "Golden Gate Park",
    category : "park" });

citiesRef.doc("DC").collection("landmarks").doc().set({
    name: "National Gallery of Art",
    category : "museum" });
citiesRef.doc("DC").collection("landmarks").doc().set({
    name: "National Mall",
    category : "park" });

Koleksiyon kapsamlı aşağıdaki tek alanlı dizini kullanarak, category alanına göre tek bir şehrin landmarks koleksiyonunu sorgulayabilirsiniz:

Toplama Dizine eklenen alanlar Sorgu kapsamı
önemli noktalar (veya ) kategorisi Toplama
Web
citiesRef.doc("SF").collection("landmarks").where("category", "==", "park")
citiesRef.doc("SF").collection("landmarks").where("category", "in", ["park", "museum"])

Örneğin, tüm şehirlerdeki önemli yerleri sorgulamak istiyorsanız bu sorguyu tüm landmarkskoleksiyonlardan oluşan koleksiyon grubunda çalıştırırsınız. Ayrıca, koleksiyon grubu kapsamına sahip bir landmarks tek alan dizini de etkinleştirmeniz gerekir:

Toplama Dizine eklenen alanlar Sorgu kapsamı
önemli noktalar (veya ) kategorisi Koleksiyon grubu

Bu dizin etkinleştirildiğinde landmarks koleksiyon grubunu sorgulayabilirsiniz:

Web
var landmarksGroupRef = db.collectionGroup("landmarks");

landmarksGroupRef.where("category", "==", "park")
landmarksGroupRef.where("category", "in", ["park", "museum"])

Filtrelenmiş veya sıralanmış sonuçlar döndüren bir koleksiyon grubu sorgusu çalıştırmak için koleksiyon grubu kapsamına sahip ilgili bir tek alan veya birleşik dizin etkinleştirmeniz gerekir. Sonuçları filtrelemeyen veya sıralamayan koleksiyon grubu sorguları için ise ek dizin tanımı gerekmez.

Örneğin, ek bir dizin etkinleştirmeden aşağıdaki koleksiyon grubu sorgusunu çalıştırabilirsiniz:

Web
db.collectionGroup("landmarks").get()

Dizin girişleri

Projenizin yapılandırılmış dizinleri ve belgenin yapısı, bir belgenin dizin girişlerinin sayısını belirler. Dizin girişleri, dizin girişi sayısı sınırına dahil edilir.

Aşağıdaki örnekte bir belgenin dizin girişleri gösterilmektedir.

Doküman

/cities/SF

city_name : "San Francisco"
temperatures : {summer: 67, winter: 55}
neighborhoods : ["Mission", "Downtown", "Marina"]

Tek alanlı dizinler

  • city_name ASC
  • city_name DESC
  • temperatures.summer ASC
  • temperatures.summer DESC
  • temperatures.winter ASC
  • temperatures.winter DESC
  • neighborhoods Dizisi İçerir (ASC ve DESC)

Birleşik dizinler

  • city_name ASC, neighborhoods ARRAY
  • city_name DESC, neighborhoods ARRAY

Dizin girişleri

Bu dizine ekleme yapılandırması, belge için aşağıdaki dizin girişlerine neden olur:

Dizin Dizine eklenen veriler
Tek alanlı dizin girişleri
city_name ASC city_name: "San Francisco"
city_name DESC city_name: "San Francisco"
temperatures.summer ASC temperatures.summer: 67
temperatures.summer DESC temperatures.summer: 67
temperatures.winter ASC temperatures.winter: 55
temperatures.winter DESC temperatures.winter: 55
neighborhoods Dizisi ASC İçerir neighborhoods: "Mission"
neighborhoods Dizisi DESC İçerir neighborhoods: "Mission"
neighborhoods Dizisi ASC İçerir neighborhoods: "Downtown"
neighborhoods Dizisi DESC İçerir neighborhoods: "Downtown"
neighborhoods Dizisi ASC İçerir neighborhoods: "Marina"
neighborhoods Dizisi DESC İçerir neighborhoods: "Marina"
Birleşik dizin girişleri
city_name ASC, neighborhoods ARRAY city_name: "San Francisco", neighborhoods: "Mission"
city_name ASC, neighborhoods ARRAY city_name: "San Francisco", neighborhoods: "Downtown"
city_name ASC, neighborhoods ARRAY city_name: "San Francisco", neighborhoods: "Marina"
city_name DESC, neighborhoods ARRAY city_name: "San Francisco", neighborhoods: "Mission"
city_name DESC, neighborhoods ARRAY city_name: "San Francisco", neighborhoods: "Downtown"
city_name DESC, neighborhoods ARRAY city_name: "San Francisco", neighborhoods: "Marina"

Endeksler ve fiyatlandırma

Dizinler, uygulamanızın depolama maliyetlerine katkıda bulunur. Dizinler için depolama alanının nasıl hesaplanacağı hakkında daha fazla bilgi edinmek için Dizin girişi boyutu bölümüne bakın.

Dizin birleştirme özelliğini kullanma

Cloud Firestore her sorgu için bir dizin kullansa da her sorgu için mutlaka bir dizin gerekmez. Birden fazla eşitlik (==) yan tümcesi ve isteğe bağlı olarak bir orderBy yan tümcesi içeren sorgular için Cloud Firestore, mevcut dizinleri yeniden kullanabilir. Cloud Firestore, daha büyük eşitlik sorguları için gereken birleşik dizinleri oluşturmak üzere basit eşitlik filtrelerinin dizinlerini birleştirebilir.

Dizin birleştirme işlemini kullanabileceğiniz durumları belirleyerek dizine ekleme maliyetlerini azaltabilirsiniz. Örneğin, bir restoran puanlama uygulamasının restaurants koleksiyonunda:

  • restoran

    • burgerthyme

      name : "Burger Thyme"
      category : "burgers"
      city : "San Francisco"
      editors_pick : true
      star_rating : 4

Bu uygulama aşağıdaki gibi sorgular kullanır. Uygulama, her zaman star_rating artan düzenine göre sıralarken category, city ve editors_pick için eşitlik yan tümcelerinin kombinasyonlarını kullanır:

Web
db.collection("restaurants").where("category", "==", "burgers")
                            .orderBy("star_rating")

db.collection("restaurants").where("city", "==", "San Francisco")
                            .orderBy("star_rating")

db.collection("restaurants").where("category", "==", "burgers")
                            .where("city", "==", "San Francisco")
                            .orderBy("star_rating")

db.collection("restaurants").where("category", "==", "burgers")
                            .where("city", "==" "San Francisco")
                            .where("editors_pick", "==", true )
                            .orderBy("star_rating")

Her sorgu için bir dizin oluşturabilirsiniz:

Toplama Dizine eklenen alanlar Sorgu kapsamı
restoranlar category, star_rating Toplama
restoranlar şehir, star_rating Toplama
restoranlar category, city, star_rating Toplama
restoranlar category, city, editors_pick, star_rating Toplama

Daha iyi bir çözüm olarak, Cloud Firestore'ın eşitlik koşulları için dizinleri birleştirme özelliğinden yararlanarak dizin sayısını azaltabilirsiniz:

Toplama Dizine eklenen alanlar Sorgu kapsamı
restoranlar category, star_rating Toplama
restoranlar şehir, star_rating Toplama
restoranlar editors_pick, star_rating Toplama

Bu dizin grubu yalnızca daha küçük değil, aynı zamanda ek bir sorguyu da destekler:

Web
db.collection("restaurants").where("editors_pick", "==", true)
                            .orderBy("star_rating")

Dizine ekleme sınırları

Aşağıdaki sınırlar dizinler için geçerlidir. Kotalar ve sınırlar hakkında daha fazla bilgi için Kotalar ve Sınırlar bölümüne bakın.

Sınır Ayrıntılar
Bir veritabanı için maksimum birleşik dizin sayısı
Bir veritabanı için maksimum tek alan yapılandırması sayısı

Alan düzeyinde bir yapılandırma, aynı alan için birden fazla yapılandırma içerebilir. Örneğin, tek alanlı dizine ekleme muafiyeti ve aynı alandaki bir TTL politikası, sınıra göre bir alan yapılandırması olarak sayılır.

Her belge için maksimum dizin girişi sayısı

40.000

Belgelerde dizin girişlerinin sayısı, aşağıdakilerin toplamına eşittir:

  • Tek alanlı dizin girişlerinin sayısı
  • Birleşik dizin girişlerinin sayısı

Cloud Firestore'ün bir belgeyi ve dizin grubunu nasıl dizin girişine dönüştürdüğünü görmek için dizin girişi sayısıyla ilgili bu örneğe göz atın.
Birleşik dizindeki maksimum alan sayısı 100
Dizin girişinin maksimum boyutu

7,5 KiB

Cloud Firestore'ün dizin girişi boyutunu nasıl hesapladığını öğrenmek için dizin girişi boyutu bölümünü inceleyin.
Bir belgenin dizin girişlerinin maksimum toplam boyutu

8 MiB

Belgelerdeki toplam boyut, aşağıdakilerin toplamına eşittir:

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

    1.500 bayt

    Boyutu 1.500 baytı aşan alan değerleri kısaltılır. Kısaltılmış alan değerleri içeren sorgular tutarsız sonuçlar verebilir.

    Dizine eklemeyle ilgili en iyi uygulamalar

    Çoğu uygulamada, dizine ekleme işlemlerinizi yönetmek için otomatik dizine ekleme özelliğini ve hata mesajı bağlantılarını kullanabilirsiniz. Ancak aşağıdaki durumlarda tek alan muafiyeti eklemek isteyebilirsiniz:

    Durum Açıklama
    Büyük dize alanları

    Sorgulamak için kullanmadığınız uzun dize değerlerini sık sık barındıran bir dize alanınız varsa alanı dizine ekleme işleminden muaf tutarak depolama maliyetlerini düşürebilirsiniz.
    Sıralı değerler içeren belgeler içeren bir koleksiyona yüksek yazma hızları

    Bir koleksiyondaki belgeler arasında sırayla artan veya azalan bir alanı (ör. zaman damgası) dizine eklerseniz koleksiyona maksimum yazma hızı saniyede 500 yazma işlemidir. Sıralı değerlere sahip alana göre sorgu yapmıyorsanız bu sınırı aşmak için alanı dizine ekleme işleminden muaf tutabilirsiniz.

    Yüksek yazma hızına sahip bir IoT kullanım alanında (ör. zaman damgası alanı içeren dokümanlar içeren bir koleksiyon) saniye başına 500 yazma işlemi sınırına yaklaşılabilir.
    TTL alanları

    TTL (geçerlilik süresi) politikalarını kullanıyorsanız TTL alanının bir zaman damgası olması gerektiğini unutmayın. TTL alanlarında dizine ekleme varsayılan olarak etkindir ve daha yüksek trafik oranlarında performansı etkileyebilir. En iyi uygulama olarak, TTL alanlarınıza tek alan muafiyetleri ekleyin.

    Büyük dizi veya harita alanları

    Büyük dizi veya eşleme alanları,doküman başına 40.000 dizin girişi sınırına yaklaşabilir. Büyük bir diziye veya harita alanına göre sorgu yapmıyorsanız bu alanı dizine ekleme kapsamı dışında tutmanız gerekir.

    Birden fazla alanda aralık ve eşitsizlik operatörleri içeren sorgular kullanıyorsanız Cloud Firestore sorgularının performansını ve maliyetini optimize etmek için göz önünde bulundurmanız gereken dizine eklemeyle ilgili hususlara bakın.

    Dizine ekleme sorunları (dizin dağılımı, INVALID_ARGUMENT hataları) nasıl çözüleceği hakkında daha fazla bilgi için sorun giderme sayfasına bakın.