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

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

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

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

הצגת הנתונים

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

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

   לדף Databases

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

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

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

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

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

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

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

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

סינון נתונים

אפשר לסנן מסמכים באוסף על סמך ערך השדה והתנאים ==,‏ !-,‏ >,‏ >=,‏ <,‏ <=,‏ 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. לוחצים על פרסום כדי לפרוס את השינויים.

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

הפעלת 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 (אינדקסים). מידע נוסף על ניהול אינדקסים