שימוש ב-Firestore Studio במהדורת Standard

שימוש ב-Firestore Studio במהדורת Standard

אפשר לנהל את מהדורת Firestore Standard באמצעות הפעולות הבאות במסוףGoogle Cloud :

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

הצגת הנתונים

אתם יכולים לראות את כל הנתונים שלכם ב-Firestore Standard Edition במסוף Google Cloud . בכלי להצגת נתונים של מהדורת Firestore Standard, לוחצים על מסמך או על אוסף כדי לפתוח את הנתונים שמוטמעים בפריט הזה.

1. נכנסים לדף Databases במסוף Google Cloud .

   לדף Databases

2. בוחרים את מסד הנתונים הרצוי מתוך רשימת מסדי הנתונים.

3. בתפריט הניווט, לוחצים על Firestore Studio.

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

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

הגדרת חלונית

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

כדי להגדיר את ההגדרות של החלונית:

1. בסרגל הכלים של כלי הצגת הנתונים, לוחצים על הגדרות החלונית .

2. בחלונית Project panel settings, מגדירים את האפשרויות הבאות:

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

3. לוחצים על Save.

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

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

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

כברירת מחדל, כלי הצגת הנתונים של מהדורת Firestore Standard מציג מסמכי אב שלא קיימים באופן הבא:

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

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

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

סינון נתונים

אפשר לסנן מסמכים באוסף על סמך ערך השדה והתנאים ==,‏ !-,‏ >,‏ >=,‏ <,‏ <=,‏ in,‏ not-in,‏ array-contains ו-array-contains-any. לדוגמה, אפשר להציג רק מסמכים שבהם הערך של השדה firstname שווה ל-Sam.

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

כדי להחיל מסנן על אוסף:

1. לוחצים על לחצן הסינון לצד מזהה אוסף:

   

2. בתפריט הוספת מסננים, בוחרים שדה מסמך, תנאי סינון וסדר מיון.

   

3. לוחצים על אישור.

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

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

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

1. נכנסים לדף Databases במסוף Google Cloud .

   לדף Databases

2. בוחרים את מסד הנתונים הרצוי מתוך רשימת מסדי הנתונים.

3. בתפריט הניווט, לוחצים על Firestore Studio.

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

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

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

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

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

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

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

   הערה: השאילתות צריכות לעמוד בדרישות ובמגבלות של מהדורת Firestore Standard לגבי שאילתות. אחרת, השאילתה תיכשל והדף יחזיר שגיאה עם הסבר לסיבת הכישלון.

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

   

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

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

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

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

  

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

  

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

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

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

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

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

1. נכנסים לדף Databases במסוף Google Cloud .

   לדף Databases

2. בוחרים את מסד הנתונים הרצוי מתוך רשימת מסדי הנתונים.

3. בתפריט הניווט, לוחצים על Firestore Studio.

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

הוספת נתונים

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

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

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

מחיקת נתונים

אפשר למחוק מסמכים או אוספים מכלי הצגת הנתונים.

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

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

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

כדי למחוק מסמך:

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

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

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

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

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

ניהול כללי אבטחה ב-Firestore

אתם יכולים לנהל ולפרוס כללי אבטחה של Firestore ישירות במסוף Google Cloud . עורך הכללים זמין ב-Firestore במצב Native במהדורות Standard ו-Enterprise.

שימוש במסוף Google Cloud

הערה: אי אפשר להשתמש במסוף Google Cloud כדי לפרוס כללי אבטחה של Firestore במסד הנתונים (default). כדי לנהל כללים עבור מסד הנתונים (default), משתמשים במסוף Firebase או ב-Firebase CLI.

ההרשאות הנדרשות

כדי לנהל ולפרוס כללי אבטחה במסוף Google Cloud , צריך את הרשאות ה-IAM הבאות:

• firebaserules.releases.create
• firebaserules.releases.delete
• firebaserules.releases.update
• firebaserules.rulesets.create
• firebaserules.rulesets.delete
• firebaserules.rulesets.list
• ‫firebaserules.rulesets.test (נדרש כדי להשתמש בסימולטור הכללים)

כדי לפרוס כללים במסוף Google Cloud :

1. נכנסים לדף Databases במסוף Google Cloud .

   לדף Databases

2. לוחצים על המזהה של מסד הנתונים שרוצים לנהל.

3. בתפריט הניווט, לוחצים על אבטחה.

4. לוחצים על הכרטיסייה כללי Firestore.

5. בעורך הכללים, צופים בכללים. כדי לערוך, לוחצים על New ruleset (ערכת כללים חדשה) או על Clone ruleset (שיבוט של ערכת כללים) ואז משנים את הכללים.

6. לוחצים על פרסום כדי לפרוס את השינויים.

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

בדיקת כללים באמצעות סימולטור הכללים

אפשר לבדוק טיוטות של כללי אבטחה מול בקשות מדומה לפני שמפעילים אותן.

כדי לבדוק כללים במסוף Google Cloud :

1. נכנסים לדף Databases במסוף Google Cloud .

   לדף Databases

2. לוחצים על המזהה של מסד הנתונים שרוצים לבדוק.

3. בתפריט הניווט, לוחצים על אבטחה.

4. לוחצים על הכרטיסייה Firestore Rules (כללי Firestore) ואז על הכרטיסייה Simulator (סימולטור).

5. בוחרים את סוג הסימולציה (get,‏ create,‏ update או delete).

6. מזינים את המיקום של מסמך היעד.

7. (אופציונלי) הגדרת נתוני מסמך לדוגמה או פרמטרים לאימות.

8. לוחצים על הפעלה כדי לראות את תוצאות ההערכה ואת ההדגשות של השורות בכלי לעריכת כללים.

הפעלת Firebase

כדי לערוך את כללי האבטחה של מסד הנתונים (default) ב-Firestore באמצעות מסוף Firebase או Firebase CLI, צריך להפעיל את Firebase בפרויקטGoogle Cloud . אם Firebase לא מופעל, אפשר להפעיל אותו בדף Security (אבטחה) במסוף Google Cloud :

התכונה 'כללי אבטחה של Firestore' משולבת באופן הדוק עם Firebase Auth ועם Firebase SDK (אינטרנט, Android, פלטפורמות של אפל). מידע נוסף על Firebase ו-Firestore זמין במאמר תחילת העבודה עם Firebase.

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

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