‫Firestore – משימת קבלת מסמך

המשימה Firestore - Document Get מאפשרת לאחזר את התוכן של מסמך Firestore יחיד. כברירת מחדל, המשימה Firestore - Document Get מאחזרת את תמונת המצב האחרונה של המסמך ממסד הנתונים של Firestore.

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

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

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

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

    הפעלה של Cloud Firestore API

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

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

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

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

    מעבר אל Application Integration

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

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

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

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

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

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

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

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

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

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

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

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

פורמט תקין: document/collection. לדוגמה, users/alovelace.

מידע נוסף זמין במאמר בנושא מודל הנתונים של Firestore.

פלט המשימה

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

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

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

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

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

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