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

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

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

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

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

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

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

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

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

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

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

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

נתוני שאילתה

אפשר לשלוח שאילתות על מסמכים בכרטיסייה Query builder שבדף Cloud Firestore Data.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

אפשר להוסיף, לערוך ולמחוק מסמכים ואוספים במסוף Firebase. כדי לנהל את הנתונים, פותחים את הכרטיסייה נתונים בקטע 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, נכנסים לכרטיסייה כללים בקטע Cloud Firestore. מידע נוסף על הגדרה והתאמה אישית של כללים

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

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

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

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