ניהול האינדקסים

MongoDB API

משתמשים ב-method‏ createIndex() כדי ליצור אינדקס טקסט. בדוגמה הבאה, כשמסמך נכתב לאוסף cities עם השדות country או food מלאים, השדות האלה עוברים אינדוקס לצורכי חיפוש.

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

כדי ליצור אינדקס לשדה, הוא צריך להיות מחרוזת או מערך של מחרוזות. אינדקסים של מערכים לא נוספים לאינדקס החיפוש. כתוצאה מכך, הפעולה indexing a.1.b תוסיף לאינדקס את something ב-{a: {1: {b: something}}}, אבל לא ב-{a: [one, {b: something}]}.

אפשר גם ליצור אינדקסים באמצעות db.runCommand(). אפשר ליצור רק אינדקס טקסט אחד לכל אוסף, אבל אפשר ליצור כמה אינדקסים מסוגים שונים באותו db.runCommand(). בדוגמה הבאה משתמשים ב-db.runCommand() כדי ליצור אינדקס טקסט:

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

הגדרה של שפת ברירת מחדל

אפשר גם לציין שפת ברירת מחדל או נתיב שדה במסמך שיכיל את שפת ברירת המחדל.

בדוגמה הבאה, myLanguageField מצוין כ-language_override. כשמסמך באוסף cities מכיל שדה בשם myLanguageField, הערך של השדה הזה משמש לקביעת השפה לאינדוקס של השדה country עבור המסמך הספציפי הזה. הערך הזה מבטל את שפת ברירת המחדל של french.

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

• אפשר להזין את השפה בשם המלא שלה (english) או בקוד השפה שלה לפי תקן ISO (en).
• אם לא מגדירים שפת ברירת מחדל, Cloud Firestore ברירת המחדל היא אנגלית.
• שדה שינוי השפה חייב להיות שדה ברמה העליונה. אם לא מגדירים את השדה הזה, ברירת המחדל שלו היא language.
• אם מגדירים את שפת ברירת המחדל לתו null, המערכת Cloud Firestore לא משתמשת בשום שדה כדי לשנות את השפה.

חלוקה של אינדקס טקסט

אפשר גם לחלק את האינדקס באמצעות שדה, כדי שתוכלו לסנן שאילתות לפי ערך שדה ספציפי. ההגדרה הזו מאפשרת להריץ שאילתות יעילות יותר אם תמיד צריך לסנן שדה ספציפי באינדקס שמתבצעת בו שאילתה.

כדי ליצור אינדקס עם מחיצה, מגדירים את השדה firestoreOptions באופן הבא:

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

כאשר:

• ‫PARTITIONED_FIELD הוא שם השדה שמשמש לחלוקה למחיצות. הערך הזה חייב להיות מחרוזת, והוא צריך להתייחס לשדה ברמה העליונה. כשמריצים שאילתה מול אינדקס עם חלוקה למחיצות, אפשר לסנן את התוצאות לפי ערך של השדה הזה. לדוגמה, אפשר לחלק את האינדקס באמצעות city. אם שדה city מוגדר באינדקס הטקסט, המשתמשים יכולים לשלוח שאילתה לגבי עיר ספציפית.

  המחיצה חייבת להיות שדה אחד בלבד. אם מחלקים אינדקס למחיצות, אפשר להריץ רק שאילתות שבהן מצוין השדה שחולק למחיצות.

מגבלות

• אפשר ליצור רק אינדקס אחד בכל בקשה.
• יומני הביקורת של יצירת אינדקס באמצעות MongoDB API משתמשים בשם השיטה google.firestore.admin.v1.FirestoreAdmin.CreateIndex.
• אפשרויות האינדקס הנתמכות מפורטות במאמר בנושא אינדקסים ומאפייני אינדקס.

מסוף Firebase

1. במסוף Firebase, עוברים לדף Firestore Database.

   מעבר אל Firestore Database

2. בוחרים מסד נתונים מתוך רשימת מסדי הנתונים.

3. בכרטיסייה Indexes, לוחצים על Create Index.

4. מזינים מזהה אוסף.

5. מוסיפים נתיב שדה אחד או יותר ובוחרים אפשרות אינדקס לכל אחד מהם.

6. לוחצים על יצירה.

7. האינדקס החדש מוצג ברשימת האינדקסים, והפעולות התואמות ל-MongoDB מתחילות ליצור את האינדקס. אחרי שהאינדקס נוצר, יופיע סימן וי ירוק ליד האינדקס. אם האינדקס לא נוצר, אפשר לעיין בקטע שגיאות ביצירת אינדקס כדי לראות מה יכולות להיות הסיבות לכך.

MongoDB API

משתמשים ב-method‏ createIndex() כדי ליצור אינדקס. לדוגמה:

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

אפשר גם ליצור אינדקס באמצעות db.runCommand(), עם אינדקס אחד לכל היותר:

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

חלוקה למחיצות של אינדקס 2dsphere

אפשר גם לחלק את האינדקס באמצעות שדה, כדי שתוכלו לסנן שאילתות לפי ערך שדה ספציפי. ההגדרה הזו מאפשרת להריץ שאילתות יעילות יותר אם תמיד צריך לסנן שדה ספציפי באינדקס שמתבצעת בו שאילתה.

כדי ליצור אינדקס עם מחיצה, מגדירים את השדה firestoreOptions באופן הבא:

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

כאשר:

• ‫PARTITIONED_FIELD הוא שם השדה שמשמש לחלוקה למחיצות. כשמריצים שאילתה מול אינדקס עם חלוקה למחיצות, אפשר לסנן את התוצאות לפי ערך של השדה הזה. לדוגמה, אם באינדקס יש שדה region למיקומים אזוריים, אפשר לבצע חלוקה של האינדקס באמצעות region כדי שהמשתמשים יוכלו לשלוח שאילתות לגבי מסעדות באזור שלהם.

  אם מחלקים אינדקס למחיצות, אפשר להריץ רק שאילתות שבהן מצוין השדה שחולק למחיצות.

מגבלות

• אפשר ליצור רק אינדקס אחד בכל בקשה.
• יומני הביקורת של יצירת אינדקס באמצעות MongoDB API משתמשים בשם השיטה google.firestore.admin.v1.FirestoreAdmin.CreateIndex.
• אפשרויות האינדקס הנתמכות מפורטות במאמר בנושא אינדקסים ומאפייני אינדקס.

מסוף Firebase

1. במסוף Firebase, עוברים לדף Firestore Database.

   מעבר אל Firestore Database

2. בוחרים מסד נתונים מתוך רשימת מסדי הנתונים.

3. בכרטיסייה Indexes, לוחצים על Create Index.

4. מזינים מזהה אוסף.

5. מוסיפים נתיב שדה אחד או יותר ובוחרים אפשרות אינדקס לכל אחד מהם.

6. לוחצים על יצירה.

7. האינדקס החדש מוצג ברשימת האינדקסים, והפעולות התואמות ל-MongoDB מתחילות ליצור את האינדקס. אחרי שהאינדקס נוצר, יופיע סימן וי ירוק ליד האינדקס. אם האינדקס לא נוצר, אפשר לעיין בקטע שגיאות ביצירת אינדקס כדי לראות מה יכולות להיות הסיבות לכך.