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

מסוף Firebase

1. במסוף Firebase, נכנסים לדף Firestore Database.

   כניסה למסד הנתונים ב-Firestore

2. בוחרים מסד נתונים מרשימת מסדי הנתונים.
3. בכרטיסייה Indexes, לוחצים על Create Index.
4. מזינים מזהה אוסף.
5. מוסיפים נתיב שדה אחד או יותר ובוחרים אפשרות אינדקס לכל אחד מהם.
6. בוחרים אפשרות לנוכחות של שדה: "לא דליל" או "דליל".
7. לוחצים על יצירה.
8. האינדקס החדש מוצג ברשימת האינדקסים, ו-Cloud Firestore מתחיל ליצור את האינדקס. כשהאינדקס ייווצר, יופיע סימן וי ירוק ליד האינדקס. אם האינדקס לא נוצר, אפשר לעיין בשגיאות ביצירת אינדקס כדי לראות את הסיבות האפשריות.

gcloud CLI

כדי ליצור אינדקס, משתמשים בפקודה gcloud firestore indexes composite create.

gcloud firestore indexes composite create \
--database='DATABASE_ID' \
--collection-group=COLLECTION \
--field-config=FIELD_CONFIGURATION \
--query-scope=collection-group \
--density=dense

מחליפים את מה שכתוב בשדות הבאים:

• ‫DATABASE_ID: מזהה מסד נתונים.
• ‫COLLECTION: שם האוסף.
• ‫FIELD_CONFIGURATION: הגדרת שדה. בכל שדה, מוסיפים את הערך --field-config=field-path=. לדוגמה:

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

  מידע נוסף על הגדרת השדות האלה זמין במאמר --field-config.

כדי ליצור אינדקס דליל, מגדירים את --density=sparse-any.

כדי ליצור אינדקס ייחודי, מוסיפים את הדגל --unique.

Terraform

משתמשים במשאב google_firestore_index.

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

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

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

מחליפים את מה שכתוב בשדות הבאים:

• ‫DATABASE_ID: מזהה מסד הנתונים שבחרתם
• ‫COLLECTION: השם של האוסף שרוצים להוסיף לאינדקס
• ‫FIELD_PATH: שם השדה שרוצים להוסיף לאינדקס
• ‫ORDER: אחד מהערכים ASCENDING או DESCENDING
• DENSITY: אחד מהשדות SPARSE_ANY או DENSE

מסוף Google Cloud

1. במסוף Google Cloud, נכנסים לדף Databases.

   כניסה לדף Databases

2. בוחרים מסד נתונים מרשימת מסדי הנתונים.
3. בתפריט הניווט, לוחצים על Indexes.
4. אופציונלי: נותנים שם לאינדקס.
5. עוברים אל סוג החיפוש ובוחרים באפשרות טקסט.
6. מזינים מזהה אוסף.
7. מגדירים שדה אחד או יותר להוספה לאינדקס.
8. מגדירים את היקף השאילתה לאינדקס.
9. בוחרים שפת ברירת מחדל.
10. אופציונלי: מגדירים נתיב לשינוי השפה לשם של שדה שמכיל את הגדרת השפה של המסמך.
11. לוחצים על יצירה.
12. האינדקס החדש מוצג ברשימת האינדקסים, ו-Cloud Firestore מתחיל ליצור את האינדקס. כשהאינדקס נוצר, מופיע סימן וי ירוק ליד האינדקס.

gcloud CLI

כדי ליצור אינדקס טקסט, משתמשים בפקודה gcloud firestore indexes composite create:

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"}]}}' \
  --search-index-options=text-language=en \
  --async

מחליפים את מה שכתוב בשדות הבאים:

• ‫DATABASE_ID: מזהה מסד נתונים.
• ‫COLLECTION_GROUP: מזהה האוסף שרוצים להוסיף לאינדקס.
• ‫FIELD_NAME: שם השדה שרוצים להוסיף לאינדקס.

הדגל --async מריץ את פעולת יצירת האינדקס ברקע.

מסוף Google Cloud

1. במסוף Google Cloud, נכנסים לדף Databases.

   כניסה לדף Databases

2. בוחרים מסד נתונים מרשימת מסדי הנתונים.
3. בתפריט הניווט, לוחצים על Indexes.
4. אופציונלי: נותנים שם לאינדקס.
5. עוברים אל Search Type ובוחרים באפשרות Geo (2dsphere)‎.
6. מזינים מזהה אוסף.
7. מגדירים שדה אחד או יותר להוספה לאינדקס.
8. מגדירים את היקף השאילתה לאינדקס.
9. לוחצים על יצירה.

האינדקס החדש מוצג ברשימת האינדקסים, ו-Cloud Firestore מתחיל ליצור את האינדקס. אחרי שהאינדקס נוצר, מופיע סימן וי ירוק ליד האינדקס.

gcloud CLI

כדי ליצור אינדקס גיאוגרפי, משתמשים בפקודה gcloud firestore indexes composite create:

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

מחליפים את מה שכתוב בשדות הבאים:

• ‫DATABASE_ID: מזהה מסד נתונים.
• ‫COLLECTION_GROUP: מזהה האוסף שרוצים להוסיף לאינדקס.
• ‫FIELD_NAME: שם השדה שרוצים להוסיף לאינדקס.

הדגל --async מריץ את פעולת יצירת האינדקס ברקע.

מסוף Firebase

1. במסוף Firebase, נכנסים לדף Firestore Database.

   כניסה למסד הנתונים ב-Firestore

2. בוחרים מסד נתונים מרשימת מסדי הנתונים.
3. לוחצים על הכרטיסייה Indexes.
4. ברשימת האינדקסים, לוחצים על הלחצן More more_vert של האינדקס שרוצים למחוק ובוחרים באפשרות Delete.
5. לוחצים על Delete Index.

gcloud CLI

1. כדי למצוא את שם האינדקס, משתמשים בפקודה gcloud firestore indexes composite list.

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

   מחליפים את DATABASE_ID במזהה מסד הנתונים.

2. כדי למחוק את האינדקס, משתמשים בפקודה gcloud firestore indexes composite delete.

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

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫INDEX_NAME: השם של האינדקס
   • ‫DATABASE_ID: מזהה מסד נתונים