Dizinleri yönet

MongoDB API

Metin dizini oluşturmak için createIndex() yöntemini kullanın. Aşağıdaki örnekte, cities koleksiyonuna country veya food alanları doldurulmuş bir doküman yazıldığında bu alanlar arama amacıyla dizine eklenir.

db.cities.createIndex({"country": "text", "food": "text"})

Dizine eklenecek alan bir dize veya dize dizisi olmalıdır. Dizi dizinleri, arama dizinine eklenmez. Sonuç olarak, a.1.b dizine eklendiğinde something, {a: {1: {b: something}}} içinde dizine eklenir ancak {a: [one, {b: something}]} içinde dizine eklenmez.

db.runCommand() ile de dizin oluşturabilirsiniz. Koleksiyon başına yalnızca bir metin dizini oluşturabilirsiniz ancak bir db.runCommand() içinde farklı türlerde birden fazla dizin oluşturabilirsiniz. Aşağıdaki örnekte, metin dizini oluşturmak için db.runCommand() kullanılmıştır:

db.runCommand({
  createIndexes: "cities",
  indexes: [
    {
      key: { "country": "text", "food": "text" },
      name: "country_text_food_text"
    }
  ]
})

Varsayılan dil belirtme

İsterseniz varsayılan bir dil veya dokümanınızda varsayılan dili içerecek bir alan yolu da belirtebilirsiniz.

Aşağıdaki örnekte myLanguageField, language_override olarak belirtilmiştir. cities koleksiyonundaki bir doküman myLanguageField adlı bir alan içerdiğinde, bu alanın değeri, ilgili doküman için country alanını dizine ekleme dilini belirlemek amacıyla kullanılır. Bu değer, french olan varsayılan dili geçersiz kılar.

db.cities.createIndex({"country": "text"}, {"default_language": "french", "language_override": "myLanguageField"})

• Dili, uzun adıyla (english) veya iki harfli ISO dil koduyla (en) girebilirsiniz.
• Varsayılan dil ayarlanmazsa Cloud Firestore varsayılan olarak İngilizceye ayarlanır.
• Dil geçersiz kılma alanı, üst düzey bir alan olmalıdır. Boş bırakılırsa dil geçersiz kılma alanı varsayılan olarak language değerine ayarlanır.
• Varsayılan dili null karakterine ayarlarsanız Cloud Firestore, dil geçersiz kılma olarak herhangi bir alan kullanmaz.

Metin dizinini bölümlere ayırma

Sorguları belirli bir alan değerine göre filtreleyebilmek için dizininizi bir alan kullanarak da bölümleyebilirsiniz. Bu yapılandırma, sorguladığınız dizinde her zaman belirli bir alanın filtrelenmesi gerekiyorsa daha yüksek performanslı sorgular çalıştırmanıza olanak tanır.

Bölüm içeren bir dizin oluşturmak için firestoreOptions alanını aşağıdaki gibi yapılandırın:

db.runCommand({
  createIndexes: "cities",
  indexes: [
    {
      key: { "country": "text", "food": "text"},
      name: "country_text_food_text"
      firestoreOptions: {"customPartitionFields": ["PARTITIONED_FIELD"]
    }
  ]
})

Nerede:

• PARTITIONED_FIELD, bölüm için kullanılan alanın adıdır. Bu değer bir dize olmalı ve üst düzey bir alana başvurmalıdır. Bölümlenmiş bir dizinde sorgu çalıştırdığınızda sonuçları bu alanın değerine göre filtreleyebilirsiniz. Örneğin, city kullanarak dizininizi bölümlere ayırabilirsiniz. Metin dizininizde bir city alanı tanımlanmışsa kullanıcılar belirli bir şehir için sorgu yapabilir.

  Bölüm yalnızca bir alan olmalıdır. Bir dizini bölümlere ayırırsanız yalnızca bölümlere ayrılmış alanın belirtildiği sorguları çalıştırabilirsiniz.

Sınırlamalar

• İstek başına yalnızca bir dizin oluşturabilirsiniz.
• MongoDB API ile dizin oluşturma için denetleme günlükleri, google.firestore.admin.v1.FirestoreAdmin.CreateIndex yöntem adını kullanır.
• Desteklenen dizin seçenekleri için dizinler ve dizin özellikleri başlıklı makaleyi inceleyin.

Firebase konsolu

1. Firebase konsolunda Firestore Veritabanı sayfasına gidin.

   Firestore Veritabanı'na git

2. Veritabanları listesinden bir veritabanı seçin.

3. Indexes (Dizinler) sekmesinde Create Index'i (Dizin Oluştur) tıklayın.

4. Koleksiyon kimliği girin.

5. Bir veya daha fazla alan yolu ekleyin ve her biri için bir dizin seçeneği belirleyin.

6. Oluştur'u tıklayın.

7. Yeni dizininiz, dizinler listesinde gösterilir ve MongoDB uyumlu işlemler dizininizi oluşturmaya başlar. Dizininiz oluşturulduğunda dizinin yanında yeşil bir onay işareti görürsünüz. Dizin oluşturulmazsa olası nedenler için Dizin oluşturma hataları bölümüne bakın.

gcloud CLI

Metin dizini oluşturmak için gcloud firestore indexes composite create komutunu kullanın. --api-scope değerini mongodb-compatible-api olarak ayarlayın.

gcloud firestore indexes composite create \
  --database='DATABASE_ID' \
  --collection-group=COLLECTION_GROUP \
  --field-config=field-path=FIELD_NAME,search-config='{"text-spec": {"index-specs": [{"index-type": "tokenized", "match-type": "match-globally"}]}}' \
  --api-scope=mongodb-compatible-api \
  --search-index-options=text-language=en \
  --async

Aşağıdakini değiştirin:

• DATABASE_ID: Veritabanı kimliği.
• COLLECTION_GROUP: Dizine eklenecek koleksiyonun kimliği.
• FIELD_NAME: Dizine eklenecek alanın adı.

--async işareti, dizin oluşturma işlemini arka planda çalıştırır.

MongoDB API

Dizin oluşturmak için createIndex() yöntemini kullanın. Örneğin:

db.restaurants.createIndex({"location" : "2dsphere", "region": "2dsphere"})

db.runCommand() ile dizin oluşturma da en fazla bir dizinle desteklenir:

db.runCommand({
  createIndexes: "restaurants",
  indexes: [
    {
      key: { "location": "2dsphere", "region": "2dsphere" },
      name: "location_2dsphere_region_2dsphere"
    }
  ]
})

2dsphere dizinini bölme

Sorguları belirli bir alan değerine göre filtreleyebilmek için dizininizi bir alan kullanarak da bölümleyebilirsiniz. Bu yapılandırma, sorguladığınız dizinde her zaman belirli bir alanın filtrelenmesi gerekiyorsa daha yüksek performanslı sorgular çalıştırmanıza olanak tanır.

Bölüm içeren bir dizin oluşturmak için firestoreOptions alanını aşağıdaki gibi yapılandırın:

db.runCommand({
  createIndexes: "restaurants",
  indexes: [
    {
      key: { "location": "2dsphere", "region": "2dsphere" },
      name: "location_2dsphere_region_2dsphere"
      firestoreOptions: {"customPartitionFields": ["PARTITIONED_FIELD"]
    }
  ]
})

Nerede:

• PARTITIONED_FIELD, bölüm için kullanılan alanın adıdır. Bölümlenmiş bir dizinde sorgu çalıştırdığınızda sonuçları bu alanın değerine göre filtreleyebilirsiniz. Örneğin, dizininizde bölgesel konumlar için bir region alanı varsa kullanıcıların kendi bölgelerindeki restoranları sorgulayabilmesi için dizininizi region kullanarak bölümlere ayırabilirsiniz.

  Bir dizini bölümlere ayırırsanız yalnızca bölümlere ayrılmış alanın belirtildiği sorguları çalıştırabilirsiniz.

Sınırlamalar

• İstek başına yalnızca bir dizin oluşturabilirsiniz.
• MongoDB API ile dizin oluşturma için denetleme günlükleri, google.firestore.admin.v1.FirestoreAdmin.CreateIndex yöntem adını kullanır.
• Desteklenen dizin seçenekleri için dizinler ve dizin özellikleri başlıklı makaleyi inceleyin.

Firebase konsolu

1. Firebase konsolunda Firestore Veritabanı sayfasına gidin.

   Firestore Veritabanı'na git

2. Veritabanları listesinden bir veritabanı seçin.

3. Indexes (Dizinler) sekmesinde Create Index'i (Dizin Oluştur) tıklayın.

4. Koleksiyon kimliği girin.

5. Bir veya daha fazla alan yolu ekleyin ve her biri için bir dizin seçeneği belirleyin.

6. Oluştur'u tıklayın.

7. Yeni dizininiz, dizinler listesinde gösterilir ve MongoDB uyumlu işlemler dizininizi oluşturmaya başlar. Dizininiz oluşturulduğunda dizinin yanında yeşil bir onay işareti görürsünüz. Dizin oluşturulmazsa olası nedenler için Dizin oluşturma hataları bölümüne bakın.

gcloud CLI

2dsphere dizini oluşturmak için gcloud firestore indexes composite create komutunu kullanın. --api-scope değerini mongodb-compatible-api olarak ayarlayın.

gcloud firestore indexes composite create \
  --database='DATABASE_ID' \
  --collection-group=COLLECTION_GROUP \
  --field-config=field-path=FIELD_NAME,search-config='{"geo-spec": {}}' \
  --api-scope=mongodb-compatible-api \
  --async

Aşağıdakini değiştirin:

• DATABASE_ID: Veritabanı kimliği.
• COLLECTION_GROUP: Dizine eklenecek koleksiyonun kimliği.
• FIELD_NAME: Dizine eklenecek alanın adı.

--async işareti, dizin oluşturma işlemini arka planda çalıştırır.