Dizinleri yönet

MongoDB API

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

•   db.restaurants.createIndex({"cuisine" : 1})
    

•   db.restaurants.createIndex({"cuisine" : 1}, {sparse: true})
    

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

    db.runCommand({"createIndexes":"restaurant", "index": [{"key": {"cuisine":1}, {"name": "cuisine_index"}]})
    

Aşağıdaki sınırlamalara dikkat edin:

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

Firebase konsolu

1. Firebase konsolunda Firestore Database sayfasına gidin.

   Firestore veritabanına gitme

2. Veritabanları listesinden bir veritabanı seçin.
3. Dizinler sekmesinde Dizin Oluştur'u 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. Alan varlığı seçeneğini (seyrek olmayan veya seyrek) belirleyin.
7. İsteğe bağlı olarak çok anahtarlı dizin seçeneğini ayarlayabilirsiniz.
8. Oluştur'u tıklayın.
9. Yeni dizininiz, dizinler listesinde gösterilir ve Cloud Firestore dizininizi oluşturmaya başlar. Dizininiz oluşturulduğunda dizinin yanında yeşil bir onay işareti görürsünüz. index oluşturulmazsa olası nedenler için Dizin oluşturma hataları bölümüne bakın.

gcloud CLI

Dizin 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 \
--field-config=FIELD_CONFIGURATION \
--query-scope=collection-group \
--density=dense \
--api-scope=mongodb-compatible-api

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

• DATABASE_ID: veritabanı kimliği.
• COLLECTION: Koleksiyon adı.
• FIELD_CONFIGURATION: alan yapılandırması. Her alan için --field-config=field-path= ekleyin. Örneğin:

      --field-config=field-path=user-id,order=descending \
      --field-config=field-path=score,order=descending
      

  Bu alanları yapılandırma hakkında daha fazla bilgi için --field-config başlıklı makaleyi inceleyin.

Seyrek dizin oluşturmak için --density=sparse-any değerini ayarlayın.

Çok anahtarlı bir dizin oluşturmak için --multikey işaretini ekleyin.

Benzersiz bir dizin oluşturmak için --unique işaretini ekleyin.

Terraform

google_firestore_index kaynağını kullanarak api_scope değerini MONGODB_COMPATIBLE_API, query_scope değerini ise COLLECTION_GROUP olarak ayarlayın.

resource "google_firestore_index" "index" {
  database    = "DATABASE_ID"
  collection  = "COLLECTION"
  api_scope   = "MONGODB_COMPATIBLE_API"
  query_scope = "COLLECTION_GROUP"

  // You can include multiple field blocks
  fields {
    field_path = "FIELD_PATH"
    order      = "ORDER"
  }

  // Optional
  multikey = true
  density  = "DENSITY"
}

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

• DATABASE_ID: Seçtiğiniz veritabanının veritabanı kimliği
• COLLECTION: Dizinlenecek koleksiyonun adı
• FIELD_PATH: Dizine eklenecek alanın adı
• ORDER: ASCENDING veya DESCENDING değerlerinden biri
• DENSITY: SPARSE_ANY veya DENSE değerlerinden biri

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 indekslenir.

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

Bir alanın dizine eklenebilmesi için dize veya dize dizisi olması gerekir. Dizi dizinleri, arama dizinine eklenmez. Bu nedenle, 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ılmaktadır:

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

Varsayılan bir dil belirtme

İsteğe bağlı olarak varsayılan bir dil veya belgenizde varsayılan dili içerecek bir alan yolu da belirtebilirsiniz.

Aşağıdaki örnekte, myLanguageField, language_override olarak belirtilmiştir. cities koleksiyonundaki bir belgede myLanguageField adlı bir alan varsa bu alanın değeri, söz konusu belgedeki country alanının dizine eklenmesi için kullanılacak dili belirlemek üzere kullanılır. Bu değer, french için 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 İngilizce olur.
• Dil geçersiz kılma alanı, üst düzey bir alan olmalıdır. Ayarlanmazsa dil geçersiz kılma alanı varsayılan olarak language olur.
• Varsayılan dili null karakterine ayarlarsanız Cloud Firestore, hiçbir alanı dil geçersiz kılma olarak kullanmaz.

Metin dizinini bölümlere ayırma

Ayrıca, 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 belirli bir alanın her zaman filtrelenmesi gerekiyorsa daha iyi performans gösteren sorgular çalıştırmanıza olanak tanır.

Bölümlendirilmiş 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 alanı referans almalıdır. Bölümlenmiş bir dizine karşı sorgu çalıştırdığınızda sonuçları bu alanın değerine göre filtreleyebilirsiniz. Örneğin, dizininizi city kullanarak bölümleyebilirsiniz. Metin dizininizde bir city alanı tanımlanmışsa kullanıcılar belirli bir şehri sorgulayabilir.

  Bölüm yalnızca bir alan olmalıdır. Bir dizini bölümlendirirseniz yalnızca bölümlendirilmiş 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 denetim günlüklerinde google.firestore.admin.v1.FirestoreAdmin.CreateIndex yöntem adı kullanılı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 gitme

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

3. Dizinler sekmesinde Dizin Oluştur'u 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 ile 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şturulmadıysa olası nedenler için Dizin oluşturma hataları bölümüne bakın.

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 işlemi en fazla bir dizinle de desteklenir:

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

2dsphere dizinini bölümlere ayırma

Ayrıca, 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 belirli bir alanın her zaman filtrelenmesi gerekiyorsa daha iyi performans gösteren sorgular çalıştırmanıza olanak tanır.

Bölümlendirilmiş 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 dizine karşı 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 restoranlarla ilgili sorgu yapabilmesi için dizininizi region kullanarak bölümleyebilirsiniz.

  Bir dizini bölümlendirirseniz yalnızca bölümlendirilmiş 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 denetim günlüklerinde google.firestore.admin.v1.FirestoreAdmin.CreateIndex yöntem adı kullanılı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 gitme

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

3. Dizinler sekmesinde Dizin Oluştur'u 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 ile 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şturulmadıysa olası nedenler için Dizin oluşturma hataları bölümüne bakın.

MongoDB API

Bir dizini silmek için dropIndex() yöntemini kullanın. Örneğin:

Dizin adını kullanarak dizin silme

db.restaurants.dropIndex("cuisine_index")

Dizin tanımını kullanarak dizin silme

db.restaurants.dropIndex({"cuisine" : 1})

Firebase konsolu

1. Firebase konsolunda Firestore Database sayfasına gidin.

   Firestore veritabanına gitme

2. Veritabanları listesinden bir veritabanı seçin.
3. Dizinler sekmesini tıklayın.
4. Dizin listesinde, silmek istediğiniz dizin için Diğer düğmesinden Sil'i seçin. more_vert
5. Dizini Sil'i tıklayın.

gcloud CLI

1. Dizinin adını bulmak için gcloud firestore indexes composite list komutunu kullanın.

   gcloud firestore indexes composite list \
   --database='DATABASE_ID'

   DATABASE_ID yerine veritabanı kimliğini yazın.

2. Dizini silmek için gcloud firestore indexes composite delete komutunu kullanın.

   gcloud firestore indexes composite delete INDEX_NAME \
   --database='DATABASE_ID'

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

   • INDEX_NAME: bir dizinin adı
   • DATABASE_ID: veritabanı kimliği