לכל משימה מקבילה

המשימה For Each Parallel מאפשרת להפעיל שילובים אחרים (שילובי משנה) מהשילוב הראשי. כמו שאפשר להבין משם המשימה, השילובים המשניים פועלים במקביל.

במשימה הזו נעשה שימוש ב-API Trigger ID כנקודת אחיזה לזיהוי השילובים להפעלה. לדוגמה, אם מציינים את מזהה הטריגר של ה-API בתור api_trigger/APITriggerX, המשימה מפעילה את כל שילובי המשנה שיש להם את מזהה הטריגר api_trigger/APITriggerX.

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

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

הגדרת המשימה 'לכל אחד במקביל'

כדי להגדיר את המשימה For Each Parallel:

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

    מעבר אל Application Integration

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

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

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

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

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

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

    כל השינויים במאפיינים נשמרים אוטומטית.

מאפייני ההגדרה

בקטע הזה מתוארים מאפייני ההגדרה של המשימה For Each Parallel.

מאפייני קלט

שם הנכס שם הפרמטר סוג הנתונים תיאור
בחירת מערך List to iterate מערך מסוג מחרוזת, מספר שלם, מספר נקודה צפה או JSON. רשימת ערכים שצריך להפעיל עבורם את שילובי המשנה. לכל ערך ברשימה מופעל תהליך משנה נפרד של שילוב, וכל התהליכים האלה פועלים במקביל.

אפשר להעביר את הערך שחוזר על עצמו לשילוב המשני על ידי הגדרת השדה Where to map individual array elements.

אפשר גם להעביר ערכים נוספים מהשילוב הראשי לשילוב המשני בשדה מיפוי לקלט נוסף של שילוב משני.

פרטי שילוב משני API Trigger ID String מזהה הטריגר של שילוב המשנה שפורסם ויופעל.

הערך הזה זמין בשדה Trigger ID של API Trigger בשילוב המשנה.

Execution strategy לא רלוונטי

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

‫ASYNC: מפעיל את שילובי המשנה במצב אסינכרוני. במצב הזה, השילוב הראשי לא ממתין לסיום השילובים המשניים. מיד אחרי הפעלת שילובי המשנה, השילוב הראשי מפעיל את המשימות הבאות.
Run all integrations with this API Trigger ID לא רלוונטי מפעיל את כל השילובים שיש להם אותו מזהה טריגר של API.

לדוגמה, אם לשילוב A ולשילוב B יש אותו מזהה טריגר של API, שני השילובים A ו-B יפעלו לכל פריט ברשימה לאיטרציה.

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

Run a single integration לא רלוונטי מריץ רק את השילוב שצוין בשדה שם השילוב. אפשר להשתמש בתגובה משילובי המשנה על ידי הגדרת הקטע Collect values from sub-integration output(s).

בכל הפעלה Where to map individual array elements String השם של משתנה הקלט של שילוב המשנה שאליו צריך למפות את רכיבי המערך. אפשר למפות את הרכיבים של המערך ישירות למשתנה קלט של שילוב משנה. אם בוחרים שילוב משני אחד, אפשר לבחור את משתנה הקלט של השילוב המשני מתוך רשימה נפתחת.
Map to additional sub-integration input(s) String אפשרות מיפוי נוספת של שילוב משני.
  • משתנה שילוב למיפוי: השם של המשתנה בשילוב הנוכחי שיועבר למשתנה הקלט של שילוב המשנה.
  • Sub-integration input to map to (קלט של שילוב משנה למיפוי): השם של משתנה הקלט של שילוב המשנה למיפוי.

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

לדוגמה, נניח שהשילוב הראשי כולל את המשתנה productID, שרוצים למפות למשתנה subIntProductID של שילוב המשנה. במקרה כזה, צריך לבחור באפשרות productID בשדה Integration variable to map from (משתנה השילוב שממנו רוצים למפות) ולהזין subIntProductID בשדה Sub-integration input to map to (קלט שילוב המשנה שאליו רוצים למפות).

Collect values from sub-integration output(s) String אם אסטרטגיית ההפעלה היא סינכרונית (SYNC) ונבחר שילוב משנה יחיד (הפעלת שילוב יחיד), אפשר לאסוף את הפלטים של שילוב המשנה למשתני מערך בשילוב הנוכחי.
  • פלט של שילוב משני לאיסוף: השם של משתנה הפלט של השילוב המשני שיצטבר.
  • משתנה שילוב לאיסוף: שם המשתנה בשילוב הנוכחי שאליו ייאספו הפלטים המצטברים.
הגדרות הביצוע Integrations to execute at a time (parallel) מספר שלם המספר המקסימלי של הרצות מקבילות שמותר לבצע בשילובים משניים. ערך ברירת המחדל הוא 50 (מקסימום 10000).

כל השילובים המשניים בקבוצת משנה פועלים באופן מלא לפני הפעלת קבוצת המשנה הבאה של השילובים המשניים.

Ignore failures בוליאני

אפשר לציין כל אחד מהערכים הבאים:

  • ‫True: המשימה מתעלמת מכשלים בשילובים משניים ומריצה את כל ההפעלות.
  • ‫False: המשימה נכשלת בגלל כשלים בשילוב המשנה, וכל ההרצות מסתיימות.

שיטות מומלצות

אלה השיטות המומלצות לשימוש במשימה For Each Parallel:

  • מגדירים את גודל הקבוצה בהתאם למגבלות המכסה שמוגדרות בשילובי המשנה.
  • כדאי להשתמש באסטרטגיית ביצוע מסוג SYNC כשרוצים לאסוף את הפלט של שילוב המשנה לשימוש מאוחר יותר.
  • כדאי להשתמש באסטרטגיית ביצוע ASYNC אם יש סיכוי שהשילוב המשני יפעל יותר מ-2 דקות.

מידע על מכסות השימוש שחלות על המשימה For Each Parallel זמין במאמר מכסות שימוש.

לתשומת ליבכם

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

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

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

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

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

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