ניהול Cloud Firestore באמצעות מסוף Firebase

אפשר לבצע את הפעולות הבאות ב-Cloud Firestore באמצעות מסוף Firebase:

• להציג, להוסיף, לערוך ולמחוק נתונים.
• יוצרים ומעדכנים את Cloud Firestore Security Rules.
• ניהול אינדקסים.
• מעקב אחר השימוש.

להצגת הנתונים

אתם יכולים לראות את כל נתוני Cloud Firestore במסוף Firebase. בכרטיסייה Cloud Firestore Data, לוחצים על מסמך או על אוסף כדי לפתוח את הנתונים שמוטמעים בתוך הפריט הזה.

פתיחת נתיב ספציפי

כדי לפתוח מסמך או קולקציה בנתיב ספציפי, לוחצים על הלחצן Edit path (עריכת הנתיב) :

סינון מסמכים באוסף

כדי לסנן את המסמכים שמפורטים באוסף, לוחצים על הלחצן Filter list (סינון הרשימה) .

מסמכי אב לא קיימים

מסמך יכול להתקיים גם אם אחד או יותר מהאבות שלו לא קיימים. לדוגמה, המסמך בנתיב /mycoll/mydoc/mysubcoll/mysubdoc יכול להתקיים גם אם המסמך האב /mycoll/mydoc לא קיים. Cloud Firestore data viewer מציג את המסמך האב שאינו קיים באופן הבא:

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

אזהרה: למרות שמסמכי אב לא קיימים מופיעים במסוף, הם לא מופיעים בשאילתות ובתמונות המצב. עליכם ליצור את המסמך כדי לכלול אותו בתוצאות השאילתה.

נתוני שאילתה

אפשר להריץ שאילתות למסמכים בכרטיסייה כלי ליצירת שאילתות בדף Cloud Firestore Data.

1. כניסה לדף Cloud Firestore Data

2. לוחצים על הכרטיסייה כלי ליצירת שאילתות.

3. בוחרים היקף שאילתה.

   בוחרים באפשרות אוסף כדי לשלוח שאילתה לאוסף יחיד. בשדה הטקסט, מזינים נתיב לאוסף.

   בוחרים באפשרות קבוצת אוספים כדי לשלוח שאילתה לכל האוספים עם אותו מזהה. בשדה Collection group מזינים מזהה של קבוצת אוספים.

   בטבלה יוצגו באופן אוטומטי מסמכים מהאוסף או מקבוצת האוספים שציינתם.

4. לוחצים על Add to query כדי לסנן את קבוצת המסמכים שהוחזרו. כברירת מחדל, הכלי ליצירת שאילתות מוסיף תנאי WHERE. אפשר לשנות את הפסקה הזו באמצעות התפריטים הנפתחים ושדות הטקסט, או לעבור לאחת מהפסקות האחרות הזמינות. כדי להמשיך ליצור שאילתות מורכבות יותר, לוחצים על הוספה לשאילתה.

   כדי להסיר תנאי של שאילתה, לוחצים על לחצן ההסרה שלו . כדי להסיר את כל תנאי השאילתה, לוחצים על ניקוי.

   הערה: השאילתות צריכות לעמוד בדרישות ובמגבלות של Cloud Firestore לשאילתות. אחרת, השאילתה נכשלת והדף מחזיר שגיאה שמתארת את הסיבה לכך.

5. לוחצים על הפעלה כדי לאחזר את התוצאות ממסד הנתונים.

דרישות ומגבלות של שאילתות

כשמשתמשים בכלי ליצירת שאילתות, חשוב לזכור את הדרישות והמגבלות הבאות לגבי שאילתות.

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

• התנאים ORDER BY חייבים להתאים לשדות בתנאים WHERE, ולהופיע באותו סדר. כברירת מחדל, התוצאות ממוינות לפי מזהה המסמך. אם מסננים לפי שדה אחר עם תנאי אחר מלבד שוויון (==), מוסיפים תנאי ORDER BY לשדה הזה.

• כל תנאי הסינון של הוראות השאילתה מסוג טווח (<, ‏ <=, ‏ >, ‏ >=) ושל הוראות השאילתה מסוג 'לא שווה' (!=, ‏ not-in) חייבים לסנן באותו שדה.

למידע נוסף על הגבלות, ראו מגבלות על שאילתות.

ניהול הנתונים

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

אפשר להוסיף, לערוך ולמחוק מסמכים ואוספים במסוף Firebase. כדי לנהל את הנתונים, פותחים את הכרטיסייה נתונים בקטע Cloud Firestore:

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

הוספת נתונים

1. לוחצים על Add collection, מזינים את שם האוסף ולוחצים על Next.
2. מזינים מזהה מסמך ספציפי או לוחצים על מזהה אוטומטי, ואז מוסיפים שדות לנתונים במסמך.
3. לוחצים על שמירה. האוסף והמסמך החדשים יופיעו בתצוגת הנתונים.
4. כדי להוסיף עוד מסמכים לאוסף, לוחצים על הוספת מסמך.

עריכת הנתונים

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

מחיקת נתונים

כדי למחוק אוסף:

1. בוחרים את האוסף שרוצים למחוק.
2. לוחצים על סמל התפריט בחלק העליון של עמודת המסמכים, ואז לוחצים על מחיקת האוסף.

כדי למחוק מסמך או את כל השדות שלו:

1. בוחרים את המסמך שרוצים למחוק.
2. לוחצים על סמל התפריט בחלק העליון של העמודה 'פרטי המסמך'. בוחרים באפשרות מחיקת המסמך או מחיקת שדות המסמך.

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

כדי למחוק שדה ספציפי במסמך:

1. בוחרים את המסמך כדי להציג את השדות שלו.
2. לוחצים על סמל המחיקה לצד השדה שרוצים למחוק.

ניהול Cloud Firestore Security Rules

כדי להוסיף, לערוך ולמחוק Cloud Firestore Security Rules במסוף Firebase, עוברים לכרטיסייה Rules בקטע Cloud Firestore. מידע נוסף על הגדרה והתאמה אישית של כללים

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

כדי ליצור אינדקסים חדשים לשאילתות ולנהל אינדקסים קיימים במסוף Firebase, עוברים לכרטיסייה Indexes בקטע Cloud Firestore. מידע נוסף על ניהול אינדקסים

מעקב אחר השימוש

כדי לעקוב אחרי השימוש ב-Cloud Firestore, פותחים את הכרטיסייה Cloud Firestore Usage במסוף Firebase. אתם יכולים להשתמש בלוח הבקרה כדי למדוד את השימוש שלכם בתקופה מסוימת.