‫Firestore – משימת אחזור באצווה

המשימה Firestore - Batch Get מאפשרת לשלוח בקשת Batch אחת ל-Cloud Firestore כדי לקבל או לאחזר את התוכן של כמה מסמכי Firestore. יכול להיות שהמסמכים שאוחזרו לא יהיו באותו סדר שבו הם נדרשו.

‫Firestore הוא מסד נתונים מסוג NoSQL לאחסון מסמכים שמיועד להתאמה לעומס (automatic scaling), לביצועים גבוהים ולפיתוח אפליקציות בקלות.

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

לפני שמגדירים את המשימה Firestore - Batch Get, צריך לבצע את המשימות הבאות בפרויקט בענן ב-Google Cloud:

  1. מפעילים את Cloud Firestore API‏ (firestore.googleapis.com).

    הפעלה של Cloud Firestore API

  2. יוצרים פרופיל אימות. Application Integration משתמש בפרופיל אימות כדי להתחבר לנקודת קצה של אימות למשימה Firestore - Batch Get.

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

הגדרת המשימה Firestore - Batch Get

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

    מעבר אל Application Integration

  2. בתפריט הניווט, לוחצים על Integrations (שילובים).

    מוצג הדף Integrations (שילובים) עם רשימה של כל השילובים שזמינים בפרויקט בענן של Google.

  3. בוחרים שילוב קיים או לוחצים על יצירת שילוב כדי ליצור שילוב חדש.

    אם יוצרים שילוב חדש:

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

  4. בסרגל הניווט של כלי העריכה של השילוב, לוחצים על משימות כדי לראות את רשימת המשימות והמחברים הזמינים.
  5. לוחצים על הרכיב Firestore - Batch Get (שליפה של נתונים מ-Firestore) וממקמים אותו בכלי לעריכת שילובים.
  6. לוחצים על הרכיב Firestore - Batch Get (שליפה של נתונים מ-Firestore באצווה) בכלי העיצוב כדי לראות את חלונית ההגדרות של המשימה Firestore - Batch Get.
  7. עוברים אל אימות ובוחרים פרופיל אימות קיים שרוצים להשתמש בו.

    זה שינוי אופציונלי. אם לא יצרתם פרופיל אימות לפני הגדרת המשימה, לוחצים על + פרופיל אימות חדש ופועלים לפי השלבים שמפורטים במאמר יצירת פרופיל אימות חדש.

  8. עוברים אל Task Input (קלט משימה) ומגדירים את שדות הקלט שמוצגים באמצעות הטבלה הבאה של Task input parameters (פרמטרים של קלט משימה).

    השינויים בשדות הקלט נשמרים אוטומטית.

פרמטרים של קלט למשימה

בטבלה הבאה מפורטים פרמטרי הקלט של המשימה Firestore - Batch Get:

מאפיין (property) סוג נתונים תיאור
אזור String המיקום של מסד הנתונים ב-Firestore. לדוגמה, us-central1.
ProjectsId String מזהה הפרויקט ב-Google Cloud.
DatabasesIdString המזהה של מסד הנתונים ב-Firestore.
בקשה JSON ראו מבנה JSON של בקשה.

פלט המשימה

המשימה Firestore - Batch Get מחזירה את נתוני המסמך בפורמט base64. כדי לקבל את מחרוזת הפלט, צריך לפענח את הערך בקידוד base64.

אסטרטגיה לטיפול בשגיאות

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

מכסות ומגבלות

מידע על מכסות ומגבלות זמין במאמר מכסות ומגבלות.

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