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

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

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

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

אתם יכולים לראות את כל הנתונים של Cloud Firestore במסוף Firebase. בקטע Databases & Storage (מסדי נתונים ואחסון) > Firestore > הכרטיסייה Data (נתונים), לוחצים על מסמך או על אוסף כדי לפתוח את הנתונים שמוטמעים בפריט הזה.

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

כדי לפתוח מסמך או אוסף בנתיב ספציפי, משתמשים בלחצן עריכת הנתיב create:

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

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

מסמכי הורה שלא קיימים

מסמך יכול להתקיים גם אם תיקיית הורה אחת או יותר שלו לא קיימת. לדוגמה, המסמך בנתיב /mycoll/mydoc/mysubcoll/mysubdoc יכול להתקיים גם אם מסמך האב /mycoll/mydoc לא קיים.

כלי הצפייה בנתונים Cloud Firestore מציג מסמך אב שלא קיים באופן הבא:

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

שאילתת נתונים

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

1. עוברים אל Cloud Firestore הדף Data.

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

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

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

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

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

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

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

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

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

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

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

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

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

מגבלות על שאילתות

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

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

אפשר להוסיף, לערוך ולמחוק מסמכים ואוספים במסוף Firebase. כדי לנהל את הנתונים, עוברים אל Databases & Storage > Firestore > הכרטיסייה Data.

הוספת נתונים

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

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

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

מחיקת נתונים

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

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

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

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

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

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

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

ניהול Cloud Firestore Security Rules

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

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

כדי ליצור אינדקסים חדשים לשאילתות ולנהל אינדקסים קיימים ממסוף Firebase, עוברים אל Databases & Storage (מסדי נתונים ואחסון) > Firestore > Indexes (אינדקסים). מידע נוסף על ניהול אינדקסים

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

כדי לעקוב אחרי השימוש ב-Cloud Firestore דרך מסוף Firebase, עוברים אל Databases & Storage (מסדי נתונים ואחסון) > Firestore > הכרטיסייה Usage (שימוש). במרכז הבקרה הזה אפשר לראות את השימוש שלכם בתקופות זמן שונות.