ביצוע פעולות CRUD במסד נתונים של MySQL

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

כדי להשלים את המדריך הזה, צריך לבצע את המשימות הבאות:

• הגדרה של מסד נתונים וטבלה בשרת MySQL
• יצירת חיבור ל-MySQL
• הגדרת שילוב לשימוש בחיבור MySQL
• בדיקת השילוב
• ביצוע פעולות אחרות בטבלת מסד הנתונים של MySQL

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

• מוודאים שיש לכם גישה לשילובים.

• מבצעים את הפעולות הבאות בפרויקט Google Cloud:

  • מקצים לחשבון השירות שרוצים להשתמש בו כדי ליצור את החיבור את התפקידים הבאים:
    • roles/secretmanager.viewer
    • roles/secretmanager.secretAccessor
  • מפעילים את השירותים הבאים:
    • ‫secretmanager.googleapis.com (Secret Manager API)
    • ‫connectors.googleapis.com (Connectors API)

    אם השירותים האלה לא הופעלו בפרויקט שלכם בעבר, תוצג לכם בקשה להפעיל אותם כשתיצרו את החיבור בדף 'יצירת חיבור'.

• מוודאים שיש לכם גישה לשרת MySQL שבו אתם יכולים ליצור מסד נתונים.

הגדרת מסד נתונים וטבלה בשרת MySQL

מתחברים לשרת MySQL ויוצרים מסד נתונים וטבלה לשימוש במדריך הזה.

1. כדי להתחבר לשרת MySQL, מריצים את הפקודה הבאה ממערכת שמותקן בה לקוח MySQL:

   mysql --host=MySQL server host name or IP address --port=MySQL server port number -uusername -ppassword

   בדוגמה הזו, מחליפים את:
   • ‫MySQL server host name or IP address בשם או בכתובת ה-IP של שרת MySQL.
   • ‫MySQL server port number עם מספר היציאה של שרת MySQL.
   • ‫username מחליפים בשם המשתמש של שרת MySQL.
   • ‫password מחליפים בסיסמה של שרת MySQL.
2. כדי ליצור מסד נתונים של MySQL לשימוש במדריך הזה, מריצים את הפקודה הבאה מלקוח MySQL:

   CREATE DATABASE tutorialDB;

3. כדי ליצור טבלה לשימוש במדריך הזה, מריצים את הפקודה הבאה מלקוח MySQL:

   create table employee
     (
     employee_id int auto_increment primary key,
     employee_first_name varchar(500) NOT null,
     employee_last_name varchar(500) NOT null,
     employee_emailID varchar(500)
     ); 

4. כדי להוסיף שורות לטבלה employee שיצרתם, מריצים את הפקודה הבאה מלקוח MySQL:

   INSERT INTO employee (employee_first_name,employee_last_name,employee_emailID) values ("Peter","Dilliard","[e-mail]");
   INSERT INTO employee (employee_first_name,employee_last_name,employee_emailID) values ("Meaghan","Webb","[e-mail]");
   

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

   SELECT * FROM employee;

   מוצגות השורות הבאות בטבלה:

   +-------------+---------------------+--------------------+------------------+
   | employee_id | employee_first_name | employee_last_name | employee_emailID |
   +-------------+---------------------+--------------------+------------------+
   |           1 | Peter               | Dilliard           | [e-mail] |
   |           2 | Meaghan             | Webb               | [e-mail] |
   +-------------+---------------------+--------------------+------------------+
   

יצירת חיבור ל-MySQL

כדי לאפשר לשילוב להתחבר למסד הנתונים של MySQL, צריך ליצור חיבור חדש למסד הנתונים של MySQL:

1. לוחצים על +יצירת חדש כדי לפתוח את הדף יצירת חיבור.
2. בקטע מיקום, בוחרים את המיקום של החיבור.
   1. ברשימה אזור, בוחרים את האזור שבו רוצים ליצור את החיבור.

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

   2. לוחצים על הבא.
3. בקטע פרטי החיבור, מזינים את הפרטים הבאים:
   1. ברשימה מחבר, בוחרים באפשרות MySQL.
   2. ברשימה Connector version (גרסת המחבר), בוחרים את גרסת המחבר.
   3. בשדה Connection Name, מזינים שם למופע החיבור.

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

      • אפשר להשתמש באותיות, במספרים או במקפים.
      • האותיות צריכות להיות קטנות.
      • השמות צריכים להתחיל באות ולהסתיים באות או במספר.
      • השמות לא יכולים להכיל יותר מ-49 תווים.
   4. אופציונלי: בשדה Description, מוסיפים תיאור של מופע החיבור.
   5. אופציונלי: מפעילים את Cloud Logging.
   6. מהרשימה Service Account, בוחרים חשבון שירות שיש לו את התפקידים הנדרשים.
   7. בשדה שם מסד הנתונים, מזינים את השם של מסד הנתונים של MySQL.
   8. אופציונלי: מגדירים את ההגדרות של צומת החיבור:
      • מספר מינימלי של צמתים: מזינים את המספר המינימלי של צמתי חיבור.
      • מספר הצמתים המקסימלי: מזינים את מספר צמתי החיבור המקסימלי.

      צומת הוא יחידה (או עותק) של חיבור שמבצעת עיבוד של עסקאות. כדי לעבד יותר עסקאות לחיבור נדרשים יותר צמתים, ולהפך: כדי לעבד פחות עסקאות נדרשים פחות צמתים. כדי להבין איך הצמתים משפיעים על התמחור של המחבר, אפשר לעיין במאמר בנושא תמחור של צמתי חיבור. אם לא מזינים ערכים, כברירת מחדל, מספר הצמתים המינימלי מוגדר כ-2 (לזמינות טובה יותר) ומספר הצמתים המקסימלי מוגדר כ-50.

   הערה: אפשר להתאים אישית את הערכים של צומת החיבור רק אם אתם לקוחות עם תשלום לפי שימוש.
   9. (אופציונלי) בקטע הגדרות מתקדמות, מסמנים את התיבה שימוש ב-proxy כדי להגדיר שרת proxy לחיבור, ומגדירים את הערכים הבאים:
   • סכימת אימות של שרת proxy: בוחרים את סוג האימות לאימות מול שרת ה-proxy. אלה סוגי האימות שנתמכים:
     • בסיסי: אימות HTTP בסיסי.
     • ‫Digest: אימות HTTP מסוג Digest.
   • משתמש proxy: שם משתמש שישמש לאימות בשרת ה-proxy.
   • סיסמת ה-Proxy: הסוד במנהל הסודות של סיסמת המשתמש.
   • סוג ה-SSL של ה-Proxy: סוג ה-SSL שבו יש להשתמש כשמתחברים לשרת ה-Proxy. אלה סוגי האימות שנתמכים:
     • אוטומטי: הגדרת ברירת המחדל. אם כתובת ה-URL היא כתובת HTTPS, נעשה שימוש באפשרות Tunnel. אם כתובת ה-URL היא כתובת HTTP, נעשה שימוש באפשרות NEVER.
     • תמיד: החיבור תמיד מופעל באמצעות SSL.
     • לעולם לא: החיבור לא מופעל באמצעות SSL.
     • מנהור: החיבור הוא דרך שרת proxy למנהור. שרת ה-proxy פותח חיבור למארח המרוחק, והתנועה זורמת הלוך ושוב דרך ה-proxy.
   • בקטע שרת Proxy, מזינים את פרטי שרת ה-Proxy.
     1. לוחצים על + הוספת יעד.
     2. בוחרים סוג יעד.
        • כתובת המארח: מציינים את שם המארח או את כתובת ה-IP של היעד.

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

          • יוצרים קובץ מצורף לשירות PSC.
          • יוצרים endpoint attachment ואז מזינים את הפרטים שלו בשדה Host address.
   10. אופציונלי: כדי להוסיף תווית לקישור, לוחצים על +הוספת תווית.
   11. לוחצים על הבא.
   12. בקטע יעדים, מזינים את הפרטים של המארח המרוחק (מערכת העורף) שאליו רוצים להתחבר.
       • מהרשימה סוג היעד בוחרים כתובת של מארח.
         • כדי לציין את שם המארח או את כתובת ה-IP של היעד, בוחרים באפשרות כתובת המארח ומזינים את הכתובת בשדה מארח 1.
         • כדי ליצור חיבור פרטי, בוחרים באפשרות Endpoint attachment (צירוף נקודת קצה). ברשימה Endpoint Attachment, בוחרים את קובץ ה-Endpoint Attachment שנוצר עבור מערכת ה-Backend.
         הערה: מידע על יצירת צירוף של נקודת קצה זמין במאמר קישוריות לרשת פרטית. אחרי שיוצרים את ההצמדה של נקודת הקצה, היא מופיעה ברשימה Endpoint Attachment.

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

         כדי להזין יעדים נוספים, לוחצים על +הוספת יעד.

       • לוחצים על הבא.
   13. בקטע Authentication (אימות), אפשר לספק פרטי כניסה:
       • בשדה שם משתמש, מזינים את שם המשתמש של MySQL לחיבור.
       • בשדה Password (סיסמה), מזינים את הסוד של Secret Manager שמכיל את הסיסמה שמשויכת לשם המשתמש ב-MySQL.
         • אם יצרתם בעבר סוד והוא לא מופיע ברשימה, בוחרים באפשרות Enter Secret Manually (הזנת סוד באופן ידני). בתיבת הדו-שיח Add a secret by resource ID (הוספת סוד לפי מזהה משאב), מעתיקים את מזהה המשאב מ-Secret Manager ומדביקים אותו.
           • כדי להשתמש בגרסה האחרונה, מעתיקים ומדביקים את מזהה המשאב מהסוד הראשי, בפורמט: "projects/project-number/secrets/secret-name"
           • כדי לבחור גרסה ספציפית, מעתיקים ומדביקים את מזהה המשאב של הגרסה הספציפית הזו, בפורמט "projects/project-number/secrets/secret-name/versions/1"

           כדי להוסיף את הסוד, לוחצים על Add Secret (הוספת סוד).

         • אם לא יצרתם סוד לשימוש עם MySQL, לוחצים על Create New Secret (יצירת סוד חדש). בתיבת הדו-שיח Create Secret, מזינים את הפרטים הבאים:
           • בשדה Name, מזינים את שם הסוד.
           • בשדה Secret value, מזינים את התוכן של הסוד או מעלים קובץ שמכיל את הסוד.
           • לוחצים על Create Secret (יצירת סוד).
       • ברשימה Secret version, בוחרים את הגרסה של סוד Password מתוך רשימת הגרסאות הזמינות בתפריט הנפתח.
       • לוחצים על הבא.
4. בקטע בדיקה, בודקים את פרטי החיבור והאימות.
5. לוחצים על יצירה.

הגדרת שילוב לשימוש בחיבור MySQL

כדי להשתמש בחיבור MySQL שיצרתם בשילוב, מוסיפים משימת Connectors בשילוב יחד עם API Trigger. API Trigger מחובר למשימה Connectors באמצעות חיבור Edge.

יצירת שילוב חדש

1. במסוף Google Cloud, עוברים לדף Integration Connectors.

   כניסה אל Integration Connectors

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

   יופיע הדף Integrations List (רשימת השילובים).

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

   השילוב ייפתח בדף של כלי העריכה לשילובים.

4. בכלי לעריכת שילובים, לוחצים על +הוספת משימה או טריגר > Tasks כדי לראות את רשימת המשימות הזמינות.
5. לוחצים על יצירת קהל חדש.
6. מזינים שם ותיאור (אופציונלי) בתיבת הדו-שיח יצירת שילוב.
   הערה: השמות של השילובים צריכים לעמוד בדרישות הבאות:

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

הוספה והגדרה של טריגר API

כדי להוסיף טריגר API לשילוב ולהגדיר אותו:

1. בכלי לעריכת שילובים, בוחרים באפשרות הוספת משימה או טריגר > טריגרים כדי להציג רשימה של טריגרים זמינים.
2. גוררים את הרכיב API Trigger אל עורך השילוב.

הוספה והגדרה של משימת מחברים

כדי להגדיר משימה של Connectors שתציג רשימה של כל הישויות בטבלה employee:

1. בוחרים באפשרות +הוספת משימה או טריגר > משימות בכלי לעריכת שילובים כדי להציג את רשימת המשימות הזמינות.
2. גוררים את הרכיב Connectors (מחברים) אל עורך השילובים.
3. לוחצים על רכיב המשימה Connectors (מחברים) בכלי העיצוב כדי להציג את חלונית הגדרת המשימה.
4. לוחצים על הגדרת המשימה.

   מופיעה תיבת הדו-שיח Configure connector task (הגדרת משימת מחבר).

5. בתיבת הדו-שיח Configure connector task:
   1. בוחרים את אזור החיבור שבו יצרתם את החיבור ל-MySQL.
   2. אחרי שבוחרים אזור, מופיעה העמודה Connection. בוחרים את חיבור ה-MySQL שיצרתם מתוך רשימת החיבורים הזמינים.
   3. אחרי שבוחרים חיבור, מופיעה העמודה Type. בוחרים באפשרות ישויות ואז באפשרות עובד מתוך רשימת הישויות הזמינות.
   4. אחרי שבוחרים סוג, מופיעה העמודה Operation. בוחרים באפשרות רשימה.
   5. לוחצים על סיום כדי להשלים את הגדרת הקישור ולסגור את תיבת הדו-שיח.

מחברים את רכיב ההפעלה של ה-API לרכיב המשימה Connectors

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

כדי להוסיף את חיבור הקצה, לוחצים על נקודת הבקרה Fork בתחתית של רכיב API Trigger. גוררים את חיבור הקצה אל נקודת הבקרה Join בחלק העליון של רכיב המשימה Connectors.

בדיקת השילוב

כדי לבדוק את השילוב:

1. לוחצים על הלחצן בדיקה בסרגל הכלים של כלי העריכה של השילוב.
2. משנים את הערך של מועד אחרון להפעלה (בדקות), אם רוצים, ואז לוחצים על בדיקת השילוב.
3. אחרי שהשילוב מסתיים בהצלחה, בחלונית Test Integration מוצגת ההודעה Integration execution succeeded. כדי לראות את היומנים, לוחצים על הצגת יומנים.
4. בקטע Response Parameters (פרמטרים של תגובה), מתחת לקטע Connector output payload (מטען ייעודי (payload) של פלט המחבר), מוצג הפלט הבא:

   [ {
       "employee_id": 1.0,
       "employee_first_name": "Peter",
       "employee_last_name": "Dilliard",
       "employee_emailID": "[e-mail]"
     },
     {
       "employee_id": 2.0,
       "employee_first_name": "Meaghan",
       "employee_last_name": "Webb",
       "employee_emailID": "[e-mail]"
     } ]

ביצוע פעולות אחרות בטבלת מסד הנתונים של MySQL

כשמגדירים משימת Connectors בשילוב, אפשר לבחור באחת מהפעולות הבאות:

• רשימה
• קבל
• יצירה
• עדכון
• מחיקה

כבר השתמשתם בפעולת הרשימה כדי להציג את כל השורות בטבלה employee. בסעיפים הבאים של המדריך הזה, תשתמשו בפעולות Get,‏ Create,‏ Update ו-Delete כדי להוסיף, לשנות או להסיר שורות מהטבלה employee.

קבלת שורה מטבלה

אם אתם יודעים את מזהה הישות (או המפתח הראשי) של השורה שאתם רוצים לאחזר, אתם יכולים לספק את הערך הזה כקלט לפעולת Get בשילוב. הפרטים שמוחזרים על ידי פעולת Get דומים לפרטים שמוחזרים על ידי פעולת List. עם זאת, בעוד שהפעולה List מאחזרת פרטים של כל השורות בטבלה שתואמות לשאילתה שצוינה, הפעולה Get מאחזרת פרטים רק של השורה בטבלה שתואמת למזהה הישות שצוין.

חשוב לזכור שפעולת List מחזירה כברירת מחדל את כל השורות בטבלה, אבל פעולת Get דורשת מזהה ישות כפרמטר חיפוש. לכן, כדי להשתמש בפעולת Get, צריך לדעת את מזהה הישות של השורה שרוצים לאחזר, או לספק ערך ברירת מחדל למזהה הישות.

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

1. לוחצים על רכיב המשימה Connectors (מחברים) בכלי העיצוב כדי להציג את חלונית הגדרת המשימה.
2. לוחצים על הגדרת המשימה.

   מופיעה תיבת הדו-שיח Configure connector task (הגדרת משימת מחבר).

3. בתיבת הדו-שיח Configure connector task (הגדרת משימת מחבר), בעמודה Operation (פעולה), בוחרים באפשרות Get (קבלת נתונים) ולוחצים על Done (סיום).
4. בחלונית ההגדרות של המשימה, בקטע Task Input (קלט המשימה), לוחצים על Entity ID (מזהה הישות).
5. בתיבת הדו-שיח Configure Variable (הגדרת משתנה), בוחרים באפשרות Use as an input to integration (שימוש כקלט לשילוב) ולוחצים על Save (שמירה).
6. לוחצים על הלחצן בדיקה בסרגל הכלים של כלי העריכה של השילוב.
7. אם רוצים, משנים את הערך של מועד סיום הביצוע (בדקות).
8. מזינים את מזהה הישות של הישות שרוצים לאחזר את הפרטים שלה. מזינים 2.
9. לוחצים על Test Integration (בדיקת השילוב).
10. אחרי שהשילוב מסתיים בהצלחה, בחלונית Test Integration מוצגת ההודעה Integration execution succeeded. כדי לראות את היומנים, לוחצים על הצגת יומנים.
11. בקטע Response Parameters (פרמטרים של תגובה), מתחת לקטע Connector output payload (מטען ייעודי (payload) של פלט המחבר), מוצג הפלט הבא:

    [ {
        "employee_id": 2.0,
        "employee_first_name": "Meaghan",
        "employee_last_name": "Webb",
        "employee_emailID": "[e-mail]"
      } ]

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

    SELECT * FROM employee WHERE employee_id=2;

    מוצגת השורה הבאה בטבלה:

    +-------------+---------------------+--------------------+------------------+
    | employee_id | employee_first_name | employee_last_name | employee_emailID |
    +-------------+---------------------+--------------------+------------------+
    |           2 | Meaghan             | Webb               | [e-mail] |
    +-------------+---------------------+--------------------+------------------+
        

הוספת שורה לטבלה

פעולת היצירה מאפשרת להוסיף שורה לטבלה. כשמשתמשים בפעולת היצירה, צריך לספק את כל הערכים של הישות במטען הייעודי (payload) של קלט המחבר.

כדי להוסיף שורה באמצעות פעולת היצירה, מבצעים את השלבים הבאים להגדרת המשימה Connectors שיצרתם קודם:

1. לוחצים על רכיב המשימה Connectors (מחברים) בכלי העיצוב כדי להציג את חלונית ההגדרות של המשימה.
2. לוחצים על הגדרת המשימה.

   מופיעה תיבת הדו-שיח Configure connector task (הגדרת משימת מחבר).

3. בתיבת הדו-שיח Configure connector task (הגדרת משימת מחבר), בעמודה Operation (פעולה), בוחרים באפשרות Create (יצירה) ואז לוחצים על Done (סיום).
4. בחלונית ההגדרה של המשימה, בקטע Task Input (קלט המשימה), לוחצים על Connector input payload (מטען ייעודי (payload) של קלט המחבר).
5. בתיבת הדו-שיח Configure Variable (הגדרת משתנה), בוחרים באפשרות Use as an input to integration (שימוש כקלט לשילוב) ולוחצים על Save (שמירה).
6. לוחצים על הלחצן בדיקה בסרגל הכלים של כלי העריכה של השילוב.
7. אם רוצים, משנים את הערך של מועד סיום הביצוע (בדקות).
8. מזינים את הפרטים של הישות שרוצים ליצור. לדוגמה, כדי להוסיף עובד חדש לטבלה employee, מזינים את ה-JSON הבא:

   {
     "employee_first_name": "Mary",
     "employee_last_name": "Smith",
     "employee_emailID": "[e-mail]"
   }

   הערה: אל תציינו את המפתח הראשי, employee_id, כי זהו ערך לקריאה בלבד שנוצר כשהשורה מתווספת לטבלה.
9. לוחצים על Test Integration (בדיקת השילוב).
10. אחרי שהשילוב מסתיים בהצלחה, בחלונית Test Integration מוצגת ההודעה Integration execution succeeded. כדי לראות את היומנים, לוחצים על הצגת יומנים.
11. בקטע Response Parameters (פרמטרים של תגובה), מתחת לקטע Connector input payload (מטען ייעודי (payload) של קלט המחבר), מוצג המטען הייעודי שסיפקתם:

    {
      "employee_first_name": "Mary",
      "employee_last_name": "Smith",
      "employee_emailID": "[e-mail]"
    }

    בקטע Connector output payload (מטען ייעודי (payload) של פלט המחבר), מזהה הישות מוצג כפלט:

    {
      "employee_id": 3.0
    }

12. אפשר לוודא שהשורה נוספה לטבלת MySQL. כדי לראות את המידע הזה בטבלת MySQL, מריצים את הפקודה הבאה מלקוח MySQL:

    SELECT * FROM employee;

    מוצגות השורות הבאות בטבלה:

    +-------------+---------------------+--------------------+------------------+
    | employee_id | employee_first_name | employee_last_name | employee_emailID |
    +-------------+---------------------+--------------------+------------------+
    |           1 | Peter               | Dilliard           | [e-mail] |
    |           2 | Meaghan             | Webb               | [e-mail] |
    |           3 | Mary                | Smith              | [e-mail] |
    +-------------+---------------------+--------------------+------------------+
        

עדכון שורה בטבלה

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

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

1. לוחצים על רכיב המשימה Connectors (מחברים) בכלי העיצוב כדי להציג את חלונית הגדרת המשימה.
2. לוחצים על הגדרת המשימה.

   מופיעה תיבת הדו-שיח Configure connector task (הגדרת משימת מחבר).

3. בתיבת הדו-שיח Configure connector task (הגדרת משימת מחבר), בעמודה Operation (פעולה), בוחרים באפשרות Update (עדכון) ולוחצים על Done (סיום).
4. בחלונית ההגדרה של המשימה, בקטע Task Input (קלט המשימה), לוחצים על Connector input payload (מטען ייעודי (payload) של קלט המחבר).
5. בתיבת הדו-שיח Configure Variable (הגדרת משתנה), בוחרים באפשרות Use as an input to integration (שימוש כקלט לשילוב) ולוחצים על Save (שמירה).
6. לאחר מכן, בחלונית הגדרת המשימה, בקטע Task Input (קלט המשימה), לוחצים על Filter clause (סעיף המסנן).
7. בתיבת הדו-שיח Configure Variable (הגדרת משתנה), בוחרים באפשרות Use as an input to integration (שימוש כקלט לשילוב) ולוחצים על Save (שמירה).
8. לוחצים על הלחצן בדיקה בסרגל הכלים של כלי העריכה של השילוב.
9. אם רוצים, משנים את הערך של מועד סיום הביצוע (בדקות).
10. מזינים את הקריטריונים שלפיהם רוצים לסנן. לדוגמה, כדי למצוא עובד עם מזהה האימייל [e-mail], מזינים:

    employee_emailID="[e-mail]"

    הערה: אם יש כמה שורות בטבלה שתואמות לקריטריוני הסינון, העדכון שמציינים בשלב הבא יתבצע בכל השורות התואמות.
11. מזינים את הערכים שרוצים לעדכן. לדוגמה, כדי לעדכן את מזהה האימייל של כל העובדים בטבלה employee שמזהה האימייל הנוכחי שלהם תואם לסעיף המסנן [e-mail], מזינים את ה-JSON הבא:

    {
      "employee_emailID": "[e-mail]"
    }

    הערה: לא צריך לציין ערכים לכל העמודות בטבלה. מזינים את הערכים שרוצים לעדכן. הערכים האחרים לא משתנים.
12. לוחצים על Test Integration (בדיקת השילוב).
13. אחרי שהשילוב מסתיים בהצלחה, בחלונית Test Integration מוצגת ההודעה Integration execution succeeded. כדי לוודא שהישות עודכנה, משתמשים בפעולת Get כדי לקבל את פרטי הישות שצוינה.
14. אפשר לוודא שהשורה עודכנה בטבלת MySQL. כדי לראות את המידע הזה בטבלת MySQL, מריצים את הפקודה הבאה מלקוח MySQL:

    SELECT * FROM employee;

    מוצגות השורות הבאות בטבלה:

    +-------------+---------------------+--------------------+------------------+
    | employee_id | employee_first_name | employee_last_name | employee_emailID |
    +-------------+---------------------+--------------------+------------------+
    |           1 | Peter               | Dilliard           | [e-mail] |
    |           2 | Meaghan             | Webb               | [e-mail] |
    |           3 | Mary                | Smith              | [e-mail]  |
    +-------------+---------------------+--------------------+------------------+
          

מחיקת שורה בטבלה

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

כדי למחוק שורה בטבלה באמצעות מזהה הישות, מבצעים את השלבים הבאים כדי להגדיר את המשימה Connectors שיצרתם קודם:

1. לוחצים על רכיב המשימה Connectors (מחברים) בכלי העיצוב כדי להציג את חלונית הגדרת המשימה.
2. לוחצים על הגדרת המשימה.

   מופיעה תיבת הדו-שיח Configure connector task (הגדרת משימת מחבר).

3. בתיבת הדו-שיח Configure connector task (הגדרת משימת מחבר), בעמודה Operation (פעולה), בוחרים באפשרות Delete (מחיקה) ואז לוחצים על Done (סיום).
4. בחלונית ההגדרות של המשימה, בקטע Task Input (קלט המשימה), לוחצים על Entity ID (מזהה הישות).
5. בתיבת הדו-שיח Configure Variable (הגדרת משתנה), בוחרים באפשרות Use as an input to integration (שימוש כקלט לשילוב) ולוחצים על Save (שמירה).
6. לוחצים על הלחצן בדיקה בסרגל הכלים של כלי העריכה של השילוב.
7. אם רוצים, משנים את הערך של מועד סיום הביצוע (בדקות).
8. מזינים את מזהה הישות של שורת הטבלה שרוצים למחוק. מזינים 3.
9. לוחצים על Test Integration (בדיקת השילוב).

10. אחרי שהשילוב מסתיים בהצלחה, בחלונית Test Integration מוצגת ההודעה Integration execution succeeded. כדי לוודא ששורת הטבלה נמחקה, משתמשים בפעולת Get כדי לקבל את הפרטים של השורה שנמחקה. הפעולה הזו אמורה להחזיר שגיאה לגבי מזהה הישות שצוין.

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

    לדוגמה, אם מחקתם את שורת הטבלה עם מזהה הישות 3, ואז ציינתם את פסוקית המסנן employee_emailID="[e-mail]" או את מזהה הישות 3 לפעולת הרשימה, פרמטרי התגובה ביומנים יציגו [].

11. אפשר לוודא שהשורה נמחקה בטבלת MySQL. כדי לוודא זאת בטבלת MySQL, מריצים את הפקודה הבאה מלקוח MySQL:

    SELECT * FROM employee;

    מוצגות השורות הבאות בטבלה:

    +-------------+---------------------+--------------------+------------------+
    | employee_id | employee_first_name | employee_last_name | employee_emailID |
    +-------------+---------------------+--------------------+------------------+
    |           1 | Peter               | Dilliard           | [e-mail] |
    |           2 | Meaghan             | Webb               | [e-mail] |
    +-------------+---------------------+--------------------+------------------+
            

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

• הוספת נתונים ל-BigQuery באמצעות משימה מקבילית מסוג For Each
• כל הגורמים המפעילים והמשימות