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ümesi varsa 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 dizinleri 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 alanlı 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ıralı 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 atanan değer, doküman yolunun tamamıdı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:
- Sorgunun koleksiyonuna, filtre özelliklerine, filtre operatörlerine ve sıralama düzenlerine karşılık gelen dizini tanımlar.
- Taramanın başladığı dizin konumunu tanımlar. Başlangıç konumu, sorgunun eşitlik filtreleriyle başlar ve ilk
orderByalanındaki aralık ve eşitsizlik filtreleriyle biter. - 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"] });
Varsayılan otomatik dizine ekleme ayarları varsayarak 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");
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 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:
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: |
| 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ğıtımı, INVALID_ARGUMENT hataları) nasıl çözüleceği hakkında daha fazla bilgi için sorun giderme sayfasına bakın.