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

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

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

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

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

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

כדי לפתוח מסמך או אוסף בנתיב ספציפי, משתמשים בלחצן Edit path :

לוחצים על הלחצן "עריכת הנתיב" כדי לפתוח מסמך או אוסף ספציפיים.

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

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

לוחצים על הלחצן "סינון הרשימה" כדי לסנן את המסמכים שמופיעים ברשימה.

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

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

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

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

מסמך הורה שלא קיים במסוף.

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

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

  1. מעבר לדף הנתונים של Cloud Firestore

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

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

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

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

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

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

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

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

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

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

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

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

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

למגבלות נוספות, ראו מגבלות על שאילתות.

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

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

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

הוספת נתונים

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

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

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

מחיקת נתונים

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

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

לוחצים על &quot;מחיקת האוסף&quot; בתפריט שבעמודת המסמכים.

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

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

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

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

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

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

לוחצים על סמל המחיקה כדי להסיר שדה ממסמך

ניהול Cloud Firestore Security Rules

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

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

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

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

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