בדף הזה מוסבר על הוספה לאינדקס של Cloud Firestore. Cloud Firestore לא יוצר אינדקסים כברירת מחדל. כדי לשפר את הביצועים של מסד הנתונים, כדאי ליצור אינדקסים לשאילתות הנפוצות ביותר.
לאינדקסים יש השפעה גדולה על הביצועים של מסד נתונים. אם קיים אינדקס לשאילתה, מסד הנתונים יכול להחזיר תוצאות ביעילות על ידי צמצום כמות הנתונים שצריך לסרוק וצמצום העבודה שנדרשת למיון התוצאות. עם זאת, רשומות האינדקס מגדילות את עלויות האחסון ואת כמות העבודה שמתבצעת במהלך פעולת כתיבה בשדות מאונדקסים.
הגדרה ומבנה של אינדקס
אינדקס מורכב מהרכיבים הבאים:
- מזהה אוסף
- רשימה של שדות באוסף הנתון
- סדר, עולה או יורד, לכל שדה
אינדקס יכול גם להפעיל את האפשרויות sparse, multikey או unique.
סידור האינדקס
הסדר וכיוון המיון של כל שדה מגדירים באופן ייחודי את האינדקס. לדוגמה, המדדים הבאים הם שני מדדים שונים ולא ניתנים להחלפה:
| איסוף | שדות |
|---|---|
| ערים | מדינה (בסדר עולה), אוכלוסייה (בסדר יורד) |
| ערים | אוכלוסייה (יורד), מדינה (עולה), |
כשיוצרים אינדקס לתמיכה בשאילתה, צריך לכלול את השדות באותו סדר כמו בשאילתה.
צפיפות האינדקס
כברירת מחדל, רשומות האינדקס מאחסנות נתונים מכל המסמכים באוסף. זה נקרא אינדקס לא דליל. ערך באינדקס יתווסף למסמך גם אם המסמך לא מכיל אף אחד מהשדות שצוינו באינדקס. כשיוצרים רשומות באינדקס, המערכת מתייחסת לשדות שלא קיימים כאילו יש להם ערך NULL. כדי לשנות את ההתנהגות הזו, אפשר להגדיר את האינדקס כאינדקס דליל.
אינדקסים דלילים
אינדקס דליל מאנדקס רק את המסמכים באוסף שמכילים ערך (כולל null) לפחות לאחד מהשדות המאונדקסים. אינדקס דליל מפחית את עלויות האחסון ויכול לשפר את הביצועים.
אינדקסים עם כמה מפתחות לערכי מערך
אם יוצרים אינדקס בשדה שמכיל ערכי מערך, צריך ליצור אינדקס מרובה מפתחות. אי אפשר להשתמש באינדקס רגיל כדי לאנדקס ערכים של מערך. אינדקס עם כמה מפתחות תומך בשדה מערך אחד בהגדרת האינדקס, ואפשר להשתמש בו לפעולות שסורקות ערכי מערך.
כדאי להשתמש באינדקסים עם כמה מפתחות רק אם יודעים שצריך ליצור אינדקס לערכי מערך. לאינדקסים רגילים יש יתרונות כשמעבדים שאילתה. לדוגמה, אינדקסים רגילים יכולים לסנן ערכים בטווח בצורה יעילה יותר.
המצבים הבאים מובילים לשגיאות כשעובדים עם ערכי מערך ועם אינדקסים של כמה מפתחות:
- פעולה מנסה להוסיף ערך של מערך לשדה שמסודר באינדקס לפי אינדקס רגיל. כדי להוסיף את ערך המערך, צריך למחוק את האינדקסים הרגילים הקיימים בשדה הזה וליצור אותם מחדש כאינדקסים מרובי-מפתחות.
- ניסיתם ליצור אינדקס רגיל בשדה שמכיל ערך של מערך. צריך ליצור אינדקס עם כמה מפתחות או למחוק את ערכי המערך.
- פעולה מנסה ליצור אינדקס של כמה שדות עם ערכי מערך. אי אפשר להשתמש ביותר משדה אחד עם ערך מערך באינדקס עם כמה מפתחות. כדי להמשיך, צריך לשנות את מודל הנתונים או את הגדרות האינדקס.
- אתם מנסים ליצור אינדקס עם כמה מפתחות שבו לשתי נתיבי שדות יש קידומת משותפת, כמו
users.postsו-users.zip.
מדדים ייחודיים
מגדירים את האפשרות 'אינדקס ייחודי' כדי לאכוף ערכים ייחודיים בשדות המאונדקסים. באינדקסים של כמה שדות, כל שילוב של ערכים חייב להיות ייחודי באינדקס. מסד הנתונים דוחה כל פעולת עדכון והוספה שמנסה ליצור רשומות אינדקס עם ערכים כפולים. אם הנתונים בשדות המאונדקסים מכילים ערכים כפולים ואתם מנסים ליצור אינדקס ייחודי, בניית האינדקס תיכשל ותוצג הודעת שגיאה בפרטי הפעולה.
שדות חסרים באינדקס ייחודי
אם מוסיפים מסמך עם שדות חסרים לאינדקס הייחודי, האינדקס מגדיר ערכים של null לשדות החסרים. רשומת האינדקס שמתקבלת חייבת להיות ייחודית, אחרת הפעולה תיכשל.
לדוגמה, עם האינדקס הזה:
db.cities.createIndex( { "name": 1 }, { unique: true } )
אם מוסיפים את המסמך {"abbreviation": "LA"} לאוסף, האינדקס הייחודי יוצר רשומה עם הערך name שמוגדר כ-null. אם תנסו להוסיף את המסמך {"abbreviation": "NYC"}, הפעולה תיכשל כי הרשומה שמתקבלת לאינדקס הייחודי זהה.
אותה התנהגות חלה על אינדקסים ייחודיים עם כמה שדות.
כשיוצרים או מעדכנים מסמך, שדות חסרים באינדקס מוגדרים לערך null, והערך שמתקבל באינדקס חייב להיות ייחודי באינדקס.
מדדי TTL
אפשר להשתמש באינדקסים של TTL כדי להסיר אוטומטית נתונים לא עדכניים ממסדי הנתונים. אינדקס TTL מציין שדה מסוים כתאריך התפוגה של מסמכים באוסף נתון. בעזרת TTL, אפשר להקטין את עלויות האחסון על ידי ניקוי נתונים לא רלוונטיים. הנתונים נמחקים בדרך כלל תוך 24 שעות אחרי תאריך התפוגה.
פתרון בעיות שקשורות ליצירת אינדקס
יכול להיות שתיתקלו בשגיאות בבניית האינדקסים כשאתם מנהלים את האינדקסים. פעולת יצירת אינדקס עלולה להיכשל אם יש בעיה בנתונים במסד הנתונים. פעולות הוספה לאינדקס יכולות להיכשל מהסיבות הבאות:
- הגעתם למגבלת האינדקס. לדוגמה, יכול להיות שהפעולה הגיעה למספר המקסימלי של רשומות אינדקס לכל מסמך. אם יצירת האינדקס נכשלת, מוצגת הודעת שגיאה. אם לא הגעתם למגבלת אינדקס, נסו שוב את פעולת האינדקס.
- נדרש אינדקס עם כמה מפתחות. לפחות אחד מהשדות שנוספו לאינדקס מכיל ערך של מערך. כדי להמשיך, צריך להשתמש באינדקס עם כמה מפתחות או למחוק את ערכי המערך.
- פעולה מנסה ליצור אינדקס של כמה שדות עם ערכי מערך. אי אפשר להשתמש ביותר משדה אחד עם ערך מערך באינדקס עם כמה מפתחות. כדי להמשיך, צריך לשנות את מודל הנתונים או את הגדרות האינדקס.
- הגדרתם את האפשרות של אינדקס ייחודי, והנתונים של השדות באינדקס יוצרים רשומות כפולות באינדקס. כדי להמשיך, צריך להסיר מהנתונים שילובים כפולים של ערכים.