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

במדריך הזה מוסבר איך להתחבר למכונה של מסד נתונים של MySQL מתוך שילוב לדוגמה, ואיך לבצע את הפעולות list, ‏ get, ‏ create, ‏ update ו-delete בטבלה של מסד נתונים של MySQL.

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

  • מוודאים שיש לכם גישה ל-Application Integration.

  • בוחרים את הפרויקט 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 --host=MYSQL_HOSTNAME_OR_IP_ADDRESS --port=PORT_NUMBER -uUSERNAME -pPASSWORD
     מחליפים את מה שכתוב בשדות הבאים:
    • ‫MYSQL_HOSTNAME_OR_IP_ADDRESS: השם או כתובת ה-IP של שרת MySQL.
    • ‫PORT_NUMBER: מספר היציאה של שרת MySQL.
    • ‫USERNAME: שם המשתמש בשרת MySQL.
    • ‫PASSWORD: הסיסמה של המשתמש לשרת MySQL.
  2. יוצרים מסד נתונים של MySQL: 
    CREATE DATABASE tutorialDB;
  3. יצירת טבלה: 
    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 שיצרתם: 
    INSERT INTO EMPLOYEE (employee_first_name,employee_last_name,employee_emailID) values ("Peter","Dilliard","test-01@test.com");
INSERT INTO EMPLOYEE (employee_first_name,employee_last_name,employee_emailID) values ("Meaghan","Webb","test-02@test.com");
  5. מוודאים שהטבלה נוצרה ושנוספו אליה שורות: 
    SELECT * FROM EMPLOYEE;
     מוצגות השורות הבאות בטבלה: 
    +-------------+---------------------+--------------------+------------------+
| employee_id | employee_first_name | employee_last_name | employee_emailID |
+-------------+---------------------+--------------------+------------------+
|           1 | Peter               | Dilliard           | test-01@test.com |
|           2 | Meaghan             | Webb               | test-02@test.com |
+-------------+---------------------+--------------------+------------------+

יצירת חיבור ל-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 של היעד.

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

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

        אם רוצים ליצור חיבור ציבורי למערכות העורפיות עם אבטחה נוספת, אפשר להגדיר כתובות 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 שיצרתם בשילוב, אתם צריכים לבצע את המשימות הבאות:

  1. יצירת שילוב חדש.
  2. הוספה והגדרה של טריגר API
  3. הוספה והגדרה של משימת מחברים
  4. קישור הרכיב API Trigger לרכיב Connectors task.

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

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

    מעבר אל Application Integration

  2. בתפריט הניווט שמימין, לוחצים על שילובים כדי לפתוח את הדף שילובים.
  3. לוחצים על יצירת שילוב.
  4. בשדה Integration name (שם השילוב), מזינים שם לשילוב.
  5. אופציונלי: בשדה תיאור, מזינים תיאור.
  6. ברשימה Region, בוחרים אזור לשילוב. ברשימה Regions מופיעים רק האזורים שהוקצו בפרויקט Google Cloud שלכם. כדי להקצות אזור חדש, לוחצים על הפעלת אזור. מידע על הקצאת אזורים חדשים זמין במאמר הפעלת אזור חדש.
  7. כדי לפתוח את עורך השילובים, לוחצים על יצירה.

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

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

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

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

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

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

    בתיבת הדו-שיח Connector Task Editor (עורך משימות של מחבר) שמופיעה, פועלים לפי השלבים הבאים:

    1. ברשימה Region, בוחרים את אזור החיבור שבו יצרתם את חיבור ה-MySQL.
    2. ברשימה Connection, בוחרים את החיבור ל-MySQL שיצרתם ולוחצים על Next.
    3. בקטע סוג, בוחרים באפשרות ישויות ולוחצים על הבא.
    4. ברשימה Entity, בוחרים באפשרות employee.
    5. ברשימה פעולה, בוחרים באפשרות רשימה ולוחצים על הבא.
    6. כדי להשלים את הגדרת החיבור ולסגור את תיבת הדו-שיח, לוחצים על סיום.

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

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

כדי להוסיף את החיבור למכשיר Edge, פועלים לפי השלבים הבאים:

  1. בתחתית הרכיב API Trigger (הפעלת API), לוחצים על נקודת הבקרה Fork (פיצול).
  2. גוררים את חיבור הקצה אל נקודת הבקרה Join בחלק העליון של רכיב המשימה Connectors.

בדיקת השילוב

כדי לבדוק את השילוב, פועלים לפי השלבים הבאים:

  1. בסרגל הכלים של עורך השילובים, לוחצים על בדיקה.
  2. אופציונלי: משנים את הערך של Execution Deadline (in minutes) (מועד סיום ההפעלה (בדקות)) ואז לוחצים על Test Integration (בדיקת השילוב).
  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": "test-01@test.com"
  },
  {
    "employee_id": 2.0,
    "employee_first_name": "Meaghan",
    "employee_last_name": "Webb",
    "employee_emailID": "test-02@test.com"
  } ]

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

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

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

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

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

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

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

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

  1. בכלי לעריכת שילובים, לוחצים על רכיב המשימה של המחברים כדי להציג את חלונית ההגדרות של מחברים.
  2. בחלונית ההגדרות מחברים, לוחצים על הגדרת מחבר. בתיבת הדו-שיח Connector Task Editor (עורך משימות של מחבר) שמופיעה, פועלים לפי השלבים הבאים:
    1. בקטע Set entities/action (הגדרת ישויות/פעולה), בוחרים באפשרות Get (קבלת נתונים) מהרשימה Operations (פעולות).
    2. לוחצים על סיום.
  3. בחלונית ההגדרות Connectors, מרחיבים את הקטע Task Input. לאחר מכן, מבצעים את הפעולות הבאות:
    1. לוחצים על מזהה הישות.
    2. בתיבת הדו-שיח Edit variable (עריכת משתנה) שמופיעה, בוחרים באפשרות Input to Integration (קלט לשילוב).
    3. לוחצים על שמירה
  4. בסרגל הכלים של עורך השילובים, לוחצים על בדיקה.
  5. אופציונלי: משנים את הערך של Execution Deadline (in minutes) (מועד סיום הביצוע (בדקות)).
  6. מזינים את מזהה הישות של הישות שרוצים לאחזר את הפרטים שלה. לדוגמה, 2.
  7. לוחצים על Test Integration (בדיקת השילוב).
  8. אחרי שהשילוב מסתיים בהצלחה, בחלונית Test Integration מוצגת ההודעה Integration execution succeeded. כדי לראות את היומנים, לוחצים על הצגת יומנים.
  9. מרחיבים את הקטע Response Parameters (פרמטרים של תגובה). בקטע Connector output payload (מטען ייעודי (payload) של פלט המחבר), מוצג הפלט הבא: 
    [ {
    "employee_id": 2.0,
    "employee_first_name": "Meaghan",
    "employee_last_name": "Webb",
    "employee_emailID": "test-02@test.com"
  } ]
  10. אפשר לוודא שהמידע שמוצג כאן זהה למידע בשורה המתאימה בטבלת MySQL. כדי לראות את המידע הזה בטבלת MySQL, מריצים את הפקודה הבאה מלקוח MySQL: 
    SELECT * FROM employee WHERE employee_id=2;
     מוצגת השורה הבאה בטבלה: 
    +-------------+---------------------+--------------------+------------------+
| employee_id | employee_first_name | employee_last_name | employee_emailID |
+-------------+---------------------+--------------------+------------------+
|           2 | Meaghan             | Webb               | test-02@test.com |
+-------------+---------------------+--------------------+------------------+

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

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

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

  1. בכלי לעריכת שילובים, לוחצים על רכיב המשימה של המחברים כדי להציג את חלונית ההגדרות של מחברים.
  2. בחלונית ההגדרות מחברים, לוחצים על הגדרת מחבר. בתיבת הדו-שיח Connector Task Editor (עורך משימות של מחבר) שמופיעה, פועלים לפי השלבים הבאים:
    1. בקטע Set entities/action, בוחרים באפשרות Create מהרשימה Operations.
    2. לוחצים על סיום.
  3. בחלונית ההגדרות Connectors, מרחיבים את הקטע Task Input. לאחר מכן, מבצעים את הפעולות הבאות:
    1. לוחצים על מזהה הישות.
    2. בתיבת הדו-שיח עריכת משתנה שמופיעה, בוחרים באפשרות קלט לשילוב.
    3. לוחצים על Save.
  4. בסרגל הכלים של עורך השילובים, לוחצים על בדיקה.
  5. אופציונלי: משנים את הערך של Execution Deadline (in minutes) (מועד סיום הביצוע (בדקות)).
  6. מזינים את הפרטים של הישות שרוצים ליצור. לדוגמה, כדי להוסיף עובד חדש לטבלה employee, מזינים את ה-JSON הבא: 
    {
  "employee_first_name": "Mary",
  "employee_last_name": "Smith",
  "employee_emailID": "test-03@test.com"
}
  7. לוחצים על Test Integration (בדיקת השילוב).
  8. אחרי שהשילוב מסתיים בהצלחה, בחלונית Test Integration מוצגת ההודעה Integration execution succeeded. כדי לראות את היומנים, לוחצים על הצגת יומנים.
  9. מרחיבים את הקטע Response Parameters (פרמטרים של תגובה). בקטע Connector output payload (מטען ייעודי (payload) של פלט המחבר), מוצג הפלט הבא: 
    {
  "employee_first_name": "Mary",
  "employee_last_name": "Smith",
  "employee_emailID": "test-03@test.com"
}
     בקטע Connector output payload (מטען ייעודי (payload) של פלט המחבר), מזהה הישות מוצג כפלט: 
    {
  "employee_id": 3.0
}
  10. אפשר לוודא שהשורה נוספה לטבלת MySQL. כדי לראות את המידע הזה בטבלת MySQL, מריצים את הפקודה הבאה מלקוח MySQL: 
    SELECT * FROM employee;
     מוצגות השורות הבאות בטבלה: 
    +-------------+---------------------+--------------------+------------------+
| employee_id | employee_first_name | employee_last_name | employee_emailID |
+-------------+---------------------+--------------------+------------------+
|           1 | Peter               | Dilliard           | test-01@test.com |
|           2 | Meaghan             | Webb               | test-02@test.com |
|           3 | Mary                | Smith              | test-03@test.com |
+-------------+---------------------+--------------------+------------------+

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

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

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

  1. בכלי לעריכת שילובים, לוחצים על רכיב המשימה של המחברים כדי להציג את חלונית ההגדרות של מחברים.
  2. בחלונית ההגדרות מחברים, לוחצים על הגדרת מחבר. בתיבת הדו-שיח Connector Task Editor (עורך משימות של מחבר) שמופיעה, פועלים לפי השלבים הבאים:
    1. בקטע Set entities/action, בוחרים באפשרות Update מהרשימה Operations.
    2. לוחצים על סיום.
  3. בחלונית ההגדרות Connectors, מרחיבים את הקטע Task Input. לאחר מכן, מבצעים את הפעולות הבאות:
    1. לוחצים על Filter clause (סעיף סינון).
    2. בתיבת הדו-שיח עריכת משתנה שמופיעה, בוחרים באפשרות קלט לשילוב.
    3. לוחצים על Save.
  4. בסרגל הכלים של עורך השילובים, לוחצים על בדיקה.
  5. אופציונלי: משנים את הערך של Execution Deadline (in minutes) (מועד סיום הביצוע (בדקות)).
  6. מזינים את הקריטריונים שלפיהם רוצים לסנן. לדוגמה, כדי למצוא עובד עם מזהה האימייל test-03@test.com, מזינים: 
    employee_emailID="test-03@test.com"
  7. מזינים את הערכים שרוצים לעדכן. לדוגמה, כדי לעדכן את מזהה האימייל של כל העובדים בטבלה employee שמזהה האימייל הנוכחי שלהם תואם לסעיף המסנן test-03@test.com, מזינים את ה-JSON הבא: 
    {
  "employee_emailID": "msmith@test.com"
}
  8. לוחצים על Test Integration (בדיקת השילוב).
  9. אחרי שהשילוב מסתיים בהצלחה, בחלונית Test Integration מוצגת ההודעה Integration execution succeeded.

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

  10. אפשר לוודא שהשורה עודכנה בטבלת MySQL. כדי לראות את המידע הזה בטבלת MySQL, מריצים את הפקודה הבאה מלקוח MySQL: 
    SELECT * FROM employee;
     מוצגות השורות הבאות בטבלה: 
    +-------------+---------------------+--------------------+------------------+
| employee_id | employee_first_name | employee_last_name | employee_emailID |
+-------------+---------------------+--------------------+------------------+
|           1 | Peter               | Dilliard           | test-01@test.com |
|           2 | Meaghan             | Webb               | test-02@test.com |
|           3 | Mary                | Smith              | msmith@test.com  |
+-------------+---------------------+--------------------+------------------+

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

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

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

  1. בכלי לעריכת שילובים, לוחצים על רכיב המשימה של המחברים כדי להציג את חלונית ההגדרות של מחברים.
  2. בחלונית ההגדרות מחברים, לוחצים על הגדרת מחבר. בתיבת הדו-שיח Connector Task Editor (עורך משימות של מחבר) שמופיעה, פועלים לפי השלבים הבאים:
    1. בקטע Set entities/action (הגדרת ישויות/פעולה), בוחרים באפשרות Get (קבלת נתונים) מהרשימה Operations (פעולות).
    2. לוחצים על סיום.
  3. בחלונית ההגדרות Connectors, מרחיבים את הקטע Task Input. לאחר מכן, מבצעים את הפעולות הבאות:
    1. לוחצים על מזהה הישות.
    2. בתיבת הדו-שיח עריכת משתנה שמופיעה, בוחרים באפשרות קלט לשילוב.
    3. לוחצים על Save.
  4. בסרגל הכלים של עורך השילובים, לוחצים על בדיקה.
  5. אופציונלי: משנים את הערך של Execution Deadline (in minutes) (מועד סיום הביצוע (בדקות)).
  6. מזינים את מזהה הישות של הישות שרוצים לאחזר את הפרטים שלה. לדוגמה, 2.
  7. לוחצים על Test Integration (בדיקת השילוב).
  8. אחרי שהשילוב מסתיים בהצלחה, בחלונית Test Integration מוצגת ההודעה Integration execution succeeded.

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

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

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

  9. אפשר לוודא שהשורה נמחקה בטבלת MySQL. כדי לוודא זאת בטבלת MySQL, מריצים את הפקודה הבאה מלקוח MySQL: 
    SELECT * FROM employee;
     מוצגות השורות הבאות בטבלה: 
    +-------------+---------------------+--------------------+------------------+
| employee_id | employee_first_name | employee_last_name | employee_emailID |
+-------------+---------------------+--------------------+------------------+
|           1 | Peter               | Dilliard           | test-01@test.com |
|           2 | Meaghan             | Webb               | test-02@test.com |
+-------------+---------------------+--------------------+------------------+

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

אפשר לנסות ליצור שילובים עם מחברים אחרים. רשימה של כל המחברים הנתמכים מופיעה במאמר כל Integration Connectors.