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

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

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

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

הערה: כדי לנהל את כללי האבטחה, צריך להשתמש במסוף Firebase.

הצגת הנתונים

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

הפעלת Firebase

כדי לערוך את כללי האבטחה של Firestore, צריך להפעיל את Firebase בפרויקט Google Cloud . אם Firebase לא מופעל, אפשר להפעיל אותו בדף כללי אבטחה:

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

צפייה בכללי האבטחה

כדי לראות את כללי האבטחה של Firestore במסוף Google Cloud , נכנסים לדף Security Rules:

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

   מעבר אל Databases

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

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

עריכת כללי האבטחה

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

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

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