אחסון נתונים ויצירת שאילתות ב-Firestore במצב Datastore

בדף הזה מוסבר איך לאחסן נתונים ב-Firestore במצב Datastore ולבצע עליהם שאילתות באמצעות Google Cloud המסוף.

לפני שמתחילים

  • נכנסים לחשבון Google Cloud . אם אתם משתמשים חדשים ב- Google Cloud, צרו חשבון כדי שתוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.

  • In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  • In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

    •

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

    • בחשבון שלכם נדרש התפקיד בעלים של Datastore, שכולל את ההרשאה datastore.databases.create שנדרשת ליצירת מופע של Datastore במצב Datastore.
    • כדי להשתמש במצב Datastore, צריך אפליקציית App Engine פעילה. אם בפרויקט אין אפליקציה, המדריך למתחילים הזה ייצור אחת בשבילכם. במקרה כזה, נדרשת ההרשאה appengine.applications.create. בעלי הפרויקט יכולים להקצות את ההרשאה הזו באמצעות תפקיד IAM בהתאמה אישית.

יצירת מסד נתונים

  1. כדי ליצור מופע חדש של מסד נתונים, פותחים את הקטע Datastore במסוף Google Cloud :
    עוברים לדף Datastore

  2. בוחרים מצב מסד נתונים.

    כשיוצרים מסד נתונים חדש ב-Firestore, אפשר להשתמש ב-Firestore במצב Native או במצב Datastore. אי אפשר להשתמש בשני המצבים באותו פרויקט.

    בוחרים אחת מאפשרויות מסד הנתונים:

    • ‫Firestore במצב Native

      מומלץ לאפליקציות לנייד ולאינטרנט. כדי להתחיל להשתמש ב-Firestore, ממשיכים אל מדריך Firestore למתחילים.

    • ‫Firestore במצב Datastore

      מומלץ לארכיטקטורות של אפליקציות עם שרתי קצה עורפי.

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

  3. בוחרים מיקום למסד הנתונים. מצב Datastore תומך במיקומים אזוריים ובמיקומים עם מספר אזורים.

    מיקום רב-אזורי מגדיל את הזמינות והעמידות. מיקומים אזוריים מציעים זמן אחזור קצר יותר לכתיבה. מידע נוסף על סוגי מיקומים זמין במאמר מיקומים במצב Datastore. המיקום חל על מסדי נתונים במצב Datastore ועל אפליקציות App Engine בפרויקט. Google Cloud

    לוחצים על יצירת מסד נתונים. אחרי שהמסד נתונים מסיים את האתחול, מוצגת הודעה במסוףGoogle Cloud שמפנה לדף Datastore Entities.

אחסון נתונים

  1. עוברים לדף Datastore Entities במסוף Google Cloud .

    כניסה לדף Entities

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

  2. לוחצים על יצירת ישות.

  3. בדף יצירת ישות, משתמשים ב-[default] בשביל מרחב שמות.

  4. מקלידים Task בשדה סוג. משאירים את מזהה המפתח עם ערך ברירת המחדל Numeric ID (auto-generated).

  5. בקטע נכסים, לוחצים על הלחצן הוספת נכס כדי להוסיף את הנכסים הבאים:

    שם סוג ערך נוספו לאינדקס
    description String מידע על Datastore
    ההגדרות האישיות נוצרו תאריך ושעה (התאריך של היום) ✓
    סיום בוליאני לא נכון ✓
    עכשיו דף היצירה אמור להיראות כך:

    חלון יצירת הישות עם הגדרות שונות של מאפיינים

  6. לוחצים על יצירה. במסוף מוצגת הישות Task שיצרתם.

הרגע אחסנתם נתונים במסד הנתונים שלכם!

הרצת שאילתה

מסדי נתונים במצב Datastore תומכים בשאילתות של נתונים לפי סוג או לפי Google Query Language ‏ (GQL). בהוראות הבאות מוסבר איך להשתמש בשניהם כדי לשלוח שאילתות למסד הנתונים.

הרצת שאילתות מסוג Kind

  1. לוחצים על Query by kind.
  2. בוחרים באפשרות Task כסוג.

בתוצאות השאילתה מוצגת הישות Task שיצרתם.

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

  1. לוחצים על הוספת פסקה של שאילתה.
  2. ברשימות הנפתחות, בוחרים באפשרויות WHERE,‏ done,‏ ==,‏ boolean ו-false.
  3. לוחצים על Run. בתוצאות מוצגת הישות Task שיצרתם, כי הערך שלה ב-done הוא false. שאילתה מסוג מסוים שהוחל עליה מסנן
  4. עכשיו משנים את סעיף השאילתה ל-WHERE, done, ==, boolean ו-true. לוחצים על הפעלה. התוצאות לא כוללות את ישות Task שיצרתם, כי הערך של done שלה הוא לא true.

הרצת שאילתות GQL

  1. לוחצים על Query by GQL.
  2. מזינים את SELECT * FROM Task בתור השאילתה. שימו לב שהסימן Task הוא תלוי אותיות רישיות (case-sensitive).
  3. לוחצים על Run query.

בתוצאות השאילתה מוצגת הישות Task שיצרתם.

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

  1. מריצים שאילתה כמו SELECT * FROM Task WHERE done=false. שימו לב שהתגים Task ו-done הם תלויי אותיות רישיות. בתוצאות מוצגת הישות Task שיצרתם, כי הערך שלה ב-done הוא false. שאילתת GQL שהופעל עליה מסנן
  2. מריצים שאילתה כמו SELECT * FROM Task WHERE done=true. התוצאות לא כוללות את הישות Task שיצרתם, כי הערך done שלה הוא לא true.

הסרת המשאבים

  1. לוחצים על Query by kind (שאילתה לפי סוג) ומוודאים שהסוג שנבחר הוא Task.
  2. לוחצים על ניקוי כדי להסיר את כל סעיפי השאילתה.
  3. בוחרים את הישות Task שיצרתם.
  4. לוחצים על מחיקה ומאשרים שרוצים למחוק את הישות Task. בהתאם לגודל חלון הדפדפן, יכול להיות שהאפשרות מחיקה תופיע בתפריט פעולות נוספות. אחרי המחיקה, הישות מוסרת באופן סופי ממסד הנתונים.

סיימתם את המדריך למתחילים!

המאמרים הבאים