Teradata

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

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

לפני שמשתמשים במחבר Teradata, צריך לבצע את המשימות הבאות:

• בפרויקט שלכם ב-Google Cloud:
  • מוודאים שהגדרתם חיבור לרשת. מידע על תבניות רשת זמין במאמר קישוריות לרשת.
  • נותנים למשתמש שמגדיר את המחבר את תפקיד ה-IAM‏ roles/connectors.admin.
  • מקצים לחשבון השירות שרוצים להשתמש בו עבור המחבר את תפקידי ה-IAM הבאים:
    • roles/secretmanager.viewer
    • roles/secretmanager.secretAccessor

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

  • מפעילים את השירותים הבאים:
    • ‫secretmanager.googleapis.com (Secret Manager API)
    • ‫connectors.googleapis.com (Connectors API)

    במאמר הפעלת שירותים מוסבר איך להפעיל שירותים.

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

הגדרת Teradata

כדי ליצור מופע של Teradata Vantage Express במכונה וירטואלית ב-Google Cloud, אפשר לעיין במאמר התקנת Teradata במכונה וירטואלית ב-Google Cloud. אם המכונה הווירטואלית הזו חשופה לציבור, אפשר להשתמש בכתובת ה-IP החיצונית שלה ככתובת המארח כשיוצרים חיבור. אם המכונה הווירטואלית לא חשופה לציבור, צריך ליצור קישוריות של Private Service Connect ולהשתמש בכתובת ה-IP של צירוף נקודת הקצה ברשת כשיוצרים חיבור.

הגדרת המחבר

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

1. במסוף Cloud, עוברים לדף Integration Connectors > Connections ובוחרים או יוצרים פרויקט בענן.

   כניסה לדף Connections

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

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

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

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

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

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

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

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

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

   2. לוחצים על הבא.
6. בקטע אימות, מזינים את פרטי האימות.
   1. בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.

      החיבור ל-Teradata תומך בסוגי האימות הבאים:

      • שם משתמש וסיסמה

   כדי להבין איך להגדיר את סוגי האימות האלה, אפשר לעיין במאמר בנושא הגדרת אימות.

   2. לוחצים על הבא.
7. בדיקה: בודקים את פרטי החיבור והאימות.
8. לוחצים על יצירה.

הגדרת אימות

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

• שם משתמש וסיסמה
  • שם משתמש: שם המשתמש של המחבר
  • סיסמה: סוד ב-Secret Manager שמכיל את הסיסמה שמשויכת למחבר.

דוגמאות להגדרת חיבור

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

אימות בסיסי – סוג החיבור

שם השדה	פרטים
מיקום	us-central1
מחבר	teradata
גרסת המחבר	1
שם החיבור	teradata-vm-connection
הפעלת Cloud Logging	כן
חשבון השירות	SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
מסד נתונים	TERADATA_TESTDB
Charset	ASCII
מספר הצמתים המינימלי	2
מספר הצמתים המקסימלי	2
סוג היעד	כתובת המארח
מארח 1	‫203.0.113.255
port 1	1025
שם משתמש	שם משתמש
סיסמה	PASSWORD
גרסה של סוד	1

ישויות, פעולות ופעולות

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

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

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

  עם זאת, יכול להיות שמחבר לא תומך בישויות או שאין לו ישויות, ובמקרה כזה הרשימה Entities תהיה ריקה.

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

  בחירה של ישות מתוך הרשימה הזמינה יוצרת רשימה של פעולות שזמינות לישות. תיאור מפורט של הפעולות זמין במאמר פעולות על ישויות של משימת המחברים. עם זאת, אם מחבר לא תומך באף אחת מהפעולות על ישויות, הפעולות הלא נתמכות האלה לא יופיעו ברשימה Operations.

• פעולה: פעולה היא פונקציה מסוג first class שזמינה לשילוב דרך ממשק המחבר. פעולה מאפשרת לבצע שינויים בישות אחת או בכמה ישויות, והיא משתנה ממתחם למתחם. בדרך כלל, לפעולה יהיו כמה פרמטרים של קלט ופרמטר של פלט. עם זאת, יכול להיות שמחבר לא תומך באף פעולה, ובמקרה כזה הרשימה Actions תהיה ריקה.

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

פעולות

המחבר הזה תומך בביצוע הפעולות הבאות:

• פונקציות ותהליכים מאוחסנים שמוגדרים על ידי המשתמש. אם יש לכם פרוצדורות מאוחסנות ופונקציות בקצה העורפי, הן מפורטות בעמודה Actions של תיבת הדו-שיח Configure connector task.
• שאילתות SQL בהתאמה אישית. כדי להריץ שאילתות SQL מותאמות אישית, המחבר מספק את הפעולה Execute custom query (הרצת שאילתה מותאמת אישית).

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

  1. פועלים לפי ההוראות המפורטות ל הוספת משימה של מחברים.
  2. כשמגדירים את משימת המחבר, בוחרים באפשרות פעולות בסוג הפעולה שרוצים לבצע.
  3. ברשימה Action, בוחרים באפשרות Execute custom query ולוחצים על Done.

     

  4. מרחיבים את הקטע Task input (קלט למשימה) ומבצעים את הפעולות הבאות:
     1. בשדה Timeout after, מזינים את מספר השניות להמתנה עד להפעלת השאילתה.

        ערך ברירת המחדל: 180 שניות.

     2. בשדה Maximum number of rows (מספר השורות המקסימלי), מזינים את מספר השורות המקסימלי שיוחזר ממסד הנתונים.

        ערך ברירת המחדל: 25.

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

        

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

        אפשר להשתמש בסימן שאלה (?) בהצהרת SQL כדי לייצג פרמטר יחיד שצריך לציין ברשימת פרמטרים של שאילתה. לדוגמה, שאילתת ה-SQL הבאה בוחרת את כל השורות מהטבלה Employees שתואמות לערכים שצוינו בעמודה LastName:

        SELECT * FROM Employees where LastName=?

        הערה: המערכת תומכת בהצהרות של שפת טיפול בנתונים (DML) ושפת הגדרת נתונים (DDL).
     5. אם השתמשתם בסימני שאלה בשאילתת ה-SQL, צריך להוסיף את הפרמטר על ידי לחיצה על + הוספת שם פרמטר לכל סימן שאלה. במהלך ההפעלה של השילוב, הפרמטרים האלה מחליפים את סימני השאלה (?) בשאילתת ה-SQL באופן עקבי. לדוגמה, אם הוספתם שלושה סימני שאלה (?), אתם צריכים להוסיף שלושה פרמטרים לפי הסדר.

        

        כדי להוסיף פרמטרים של שאילתה:

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

     הפעולה Execute custom query לא תומכת במשתני מערך.

מגבלות המערכת

מחבר Teradata יכול לעבד עד 70 עסקאות בשנייה, לכל צומת, ומגביל את כל העסקאות שחורגות מהמגבלה הזו. כברירת מחדל, Integration Connectors מקצה 2 צמתים (לזמינות טובה יותר) לחיבור.

מידע על המגבלות שחלות על Integration Connectors זמין במאמר מגבלות.

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

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

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

סוגי נתונים נתמכים

אלה סוגי הנתונים הנתמכים במחבר הזה:

• BIGINT
• BINARY
• BIT
• בוליאני
• CHAR
• תאריך
• DECIMAL
• DOUBLE
• FLOAT
• מספר שלם
• LONGN VARCHAR
• LONG VARCHAR
• NCHAR
• NUMERIC
• NVARCHAR
• REAL
• SMALL INT
• שעות
• TIMESTAMP
• TINY INT
• VARBINARY
• VARCHAR

פעולות

מחבר Oracle DB מאפשר לכם להריץ את הפרוצדורות המאוחסנות, הפונקציות והשאילתות המותאמות אישית שלכם ב-SQL בפורמט שנתמך על ידי מסד הנתונים של Oracle. כדי להריץ שאילתות SQL מותאמות אישית, המחבר מספק את הפעולה ExecuteCustomQuery.

פעולת ExecuteCustomQuery

הפעולה הזו מאפשרת להריץ שאילתות SQL מותאמות אישית.

פרמטרים של קלט לפעולה ExecuteCustomQuery

שם הפרמטר	סוג הנתונים	חובה	תיאור
שאילתה	String	כן	השאילתה להרצה.
queryParameters	מערך JSON בפורמט הבא: [{"value": "VALUE", "dataType": "DATA_TYPE"}]	לא	פרמטרים של שאילתה.
maxRows	מספר	לא	מספר השורות המקסימלי שיוחזרו.
זמן קצוב לתפוגה	מספר	לא	מספר השניות להמתנה עד להרצת השאילתה.

פרמטרים של פלט הפעולה ExecuteCustomQuery

אם הפעולה בוצעה ללא שגיאות, היא מחזירה את הסטטוס 200 (OK) עם גוף תגובה שכולל את תוצאות השאילתה.

דוגמה להגדרת הפעולה ExecuteCustomQuery מופיעה במאמר דוגמאות.

כדי להבין איך להשתמש בפעולה ExecuteCustomQuery, אפשר לעיין בדוגמאות לפעולות.

דוגמאות לפעולות

בקטע הזה מוסבר איך לבצע חלק מהפעולות במחבר הזה.

דוגמה – הפעלת שאילתה עם קיבוץ לפי

1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
2. בוחרים את הפעולה ExecuteCustomQuery ולוחצים על סיום.
3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value:

   {
   "query": "select E.EMPLOYEE_ID,E.EMPLOYEE_NAME,E.CITY from EMPLOYEES E LEFT JOIN EMPLOYEE_DEPARTMENT ED ON E.EMPLOYEE_ID=ED.ID where E.EMPLOYEE_NAME = 'John' Group by E.CITY,E.EMPLOYEE_ID,E.EMPLOYEE_NAME"
   }

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

דוגמה – הפעלת שאילתה שמכילה פרמטרים

1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
2. בוחרים את הפעולה ExecuteCustomQuery ולוחצים על סיום.
3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value:

   {
   "query": "select C.ID,C.NAME,C.CITY,C.O_DATE,E.EMPLOYEE_ID from customqueries C,Employees E where C.ID=E.Employee_id and C.NAME=?",
   "queryParameters": [{
         "value": "John",
         "dataType": "VARCHAR"
   }],
   "timeout":10,
   "maxRows":3
   }

בדוגמה הזו נבחרו רשומות של עובדים שבהן שם העובד הוא John. שימו לב ששם העובד מוגדר כפרמטר באמצעות הפרמטר queryParameters. אם הפעולה מצליחה, לפרמטר connectorOutputPayload response של משימת המחבר יהיה ערך שדומה לערך הבא:

[{
"NAME": "John",
"O_DATE": "2023-06-01 00:00:00.0",
"EMPLOYEE_ID": 1.0
}, {
"NAME": "John",
"O_DATE": "2021-07-01 00:00:00.0",
"EMPLOYEE_ID": 3.0
}, {
"NAME": "John",
"O_DATE": "2022-09-01 00:00:00.0",
"EMPLOYEE_ID": 4.0
}]

דוגמה – הוספת רשומה באמצעות ערך רצף

1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
2. בוחרים את הפעולה ExecuteCustomQuery ולוחצים על סיום.
3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value:

   {
   "query": "INSERT INTO AUTHOR(id,title) VALUES(author_table_id_seq.NEXTVAL,'Sample_book_title')"
   }

בדוגמה הזו מוסיפים רשומה לטבלה AUTHOR באמצעות אובייקט רצף קיים author_table_id_seq. אם הפעולה מצליחה, לפרמטר connectorOutputPayload response של משימת המחבר יהיה ערך שדומה לערך הבא:

[{
}]

דוגמה – הפעלת שאילתה עם פונקציית צבירה

1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
2. בוחרים את הפעולה ExecuteCustomQuery ולוחצים על סיום.
3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value:

   {
   "query": "SELECT SUM(SALARY) as Total FROM EMPLOYEES"
   }

בדוגמה הזו מחושב הערך המצטבר של המשכורות בטבלה EMPLOYEES. אם הפעולה מצליחה, לפרמטר connectorOutputPayload response של משימת המחבר יהיה ערך שדומה לערך הבא:

[{
"TOTAL": 13000.0
}]  
  

דוגמה – יצירת טבלה חדשה

1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
2. בוחרים את הפעולה ExecuteCustomQuery ולוחצים על סיום.
3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value:

   {
   "query": "CREATE TABLE TEST1 (ID INT, NAME VARCHAR(40),DEPT VARCHAR(20),CITY VARCHAR(10))"
   }

בדוגמה הזו נוצרת הטבלה TEST1. אם הפעולה מצליחה, לפרמטר connectorOutputPayload response של משימת המחבר יהיה ערך שדומה לערך הבא:

[{
}]

דוגמאות לפעולות על ישויות

דוגמה – רשימת כל העובדים

בדוגמה הזו מוצגת רשימה של כל העובדים בישות Employee.

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות Employee מהרשימה Entity.
3. בוחרים את הפעולה List ולוחצים על סיום.
4. אופציונלי: בקטע Task Input (קלט משימה) במשימה Connectors (מחברים), אפשר לסנן את קבוצת התוצאות על ידי ציון filter clause (סעיף סינון).

דוגמה – קבלת פרטי עובד

בדוגמה הזו מוצגים הפרטים של העובד עם המזהה שצוין, מהישות Employee.

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות Employee מהרשימה Entity.
3. בוחרים את הפעולה Get ולוחצים על סיום.
4. בקטע Task Input (קלט של משימה) במשימה Connectors (מחברים), לוחצים על EntityId (מזהה ישות) ואז מזינים 45 בשדה Default Value (ערך ברירת מחדל).

   כאן, 45 הוא ערך המפתח הראשי של הישות Employee.

דוגמה – יצירת רשומת עובד

בדוגמה הזו מוסיפים רשומה חדשה של עובד לישות Employee.

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות Employee מהרשימה Entity.
3. בוחרים את הפעולה Create ולוחצים על סיום.
4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value:

   {
   "EMPLOYEE_ID": 69.0,
   "EMPLOYEE_NAME": "John",
   "CITY": "Bangalore"
   }

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

    {
   "ROWID": "AAAoU0AABAAAc3hAAF"
   }

דוגמה – עדכון רשומת עובד

בדוגמה הזו מתבצע עדכון של רשומת העובד עם המזהה 69 בישות Employee.

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות Employee מהרשימה Entity.
3. בוחרים את הפעולה Update ולוחצים על סיום.
4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך שדומה לערך הבא בשדה Default Value:

   {
   "EMPLOYEE_NAME": "John",
   "CITY": "Mumbai"
   }

5. לוחצים על entityId ואז מזינים 69 בשדה ערך ברירת מחדל.

   לחלופין, במקום לציין את entityId, אפשר גם להגדיר את filterClause ל-69.

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

   {
   }

דוגמה – מחיקת רשומת עובד

בדוגמה הזו נמחק רשומת העובד עם המזהה שצוין בישות Employee.

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות Employee מהרשימה Entity.
3. בוחרים את הפעולה Delete ולוחצים על סיום.
4. בקטע Task Input (קלט משימה) של המשימה Connectors (מחברים), לוחצים על entityId ואז מזינים 35 בשדה Default Value (ערך ברירת מחדל).

יצירת חיבורים באמצעות Terraform

אפשר להשתמש במשאב של Terraform כדי ליצור חיבור חדש.

כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.

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

כשיוצרים את החיבור הזה באמצעות Terraform, צריך להגדיר את המשתנים הבאים בקובץ ההגדרות של Terraform:

שם הפרמטר	סוג נתונים	חובה	תיאור
client_charset	מחרוזת	נכון	מציין את ערכת התווים של Java לקידוד ולפענוח של נתוני תווים שמועברים אל מסד הנתונים של Teradata וממנו.
מסד נתונים	מחרוזת	נכון	מסד הנתונים שנבחר כברירת המחדל כשפותחים חיבור ל-Teradata.
חשבון	מחרוזת	לא נכון	ההגדרה מציינת מחרוזת חשבון שתחליף את מחרוזת החשבון שמוגדרת כברירת מחדל למשתמש במסד הנתונים של Teradata.
charset	מחרוזת	נכון	מציין את ערכת התווים של הסשן לקידוד ולפענוח של נתוני תווים שמועברים אל מסד הנתונים של Teradata וממנו. ערך ברירת המחדל הוא ASCII.
column_name	מספר שלם	נכון	הגדרת ההתנהגות של השיטות ResultSetMetaData getColumnName ו-getColumnLabel.
connect_failure_ttl	מחרוזת	לא נכון	האפשרות הזו מאפשרת ל-CData ADO.NET Provider for Teradata לזכור את השעה של הכשל האחרון בחיבור לכל שילוב של כתובת IP ויציאה. בנוסף, ספק CData ADO.NET ל-Teradata מדלג על ניסיונות חיבור לכתובת ה-IP או ליציאה הזו במהלך התחברויות עתידיות למשך מספר השניות שצוין בערך של Connect Failure time-to-live (זמן החיים של שגיאת חיבור, CONNECTFAILURETTL).
connect_function	מחרוזת	לא נכון	מציין אם מסד הנתונים של Teradata צריך להקצות מספר רצף כניסה (LSN) לסשן הזה או לשייך את הסשן הזה ל-LSN קיים.
שוטר	מחרוזת	לא נכון	המדיניות הזו קובעת אם מתבצעת בדיקה של תאימות ל-COP.
cop_last	מחרוזת	לא נכון	מציינת איך התכונה 'גילוי COP' קובעת את שם המארח האחרון של COP.
ddstats	ENUM	לא נכון	מציינים את הערך של DDSTATS. הערכים הנתמכים הם: ON, ‏ OFF
disable_auto_commit_in_batch	בוליאני	נכון	ההגדרה קובעת אם להשבית את השמירה האוטומטית כשמבצעים את פעולת האצווה.
encrypt_data	ENUM	לא נכון	מציינים את הערך של EncryptData, ‏ ON או OFF. הערכים הנתמכים הם: ON, ‏ OFF
error_query_count	מחרוזת	לא נכון	מציין את המספר המקסימלי של פעמים שבהן JDBC FastLoad ינסה לשלוח שאילתה לטבלת השגיאות של FastLoad 1 אחרי פעולת JDBC FastLoad.
error_query_interval	מחרוזת	לא נכון	מציינת את מספר אלפיות השנייה ש-JDBC FastLoad ימתין בין ניסיונות לשאילתת FastLoad Error Table 1 אחרי פעולת JDBC FastLoad.
error_table1_suffix	מחרוזת	לא נכון	מציין את הסיומת של שם טבלת השגיאות 1 של FastLoad שנוצרה על ידי JDBC FastLoad ו-JDBC FastLoad CSV.
error_table2_suffix	מחרוזת	לא נכון	מציין את הסיומת של השם של טבלת השגיאות 2 של FastLoad שנוצרה על ידי JDBC FastLoad ו-JDBC FastLoad CSV.
error_table_database	מחרוזת	לא נכון	מציין את שם מסד הנתונים של טבלאות השגיאות של FastLoad שנוצרו על ידי JDBC FastLoad ו-JDBC FastLoad CSV.
field_sep	מחרוזת	לא נכון	מציין מפריד שדות לשימוש רק עם JDBC FastLoad CSV. מפריד ברירת המחדל הוא ',' (פסיק).
finalize_auto_close	מחרוזת	לא נכון	מציינים את הערך של FinalizeAutoClose, ‏ ON או OFF.
geturl_credentials	מחרוזת	לא נכון	מציינים את הערך של GeturlCredentials, ‏ ON או OFF.
שליטה	מחרוזת	לא נכון	מציינים את הערך GOVERN, ‏ ON או OFF.
literal_underscore	מחרוזת	לא נכון	הוספת תו בריחה אוטומטית לדפוסי LIKE-predicate בקריאות DatabaseMetaData, כמו schemPattern ו-tableNamePattern.
lob_support	מחרוזת	לא נכון	מציינים את הערך של LobSupport, ‏ ON או OFF.
lob_temp_table	מחרוזת	לא נכון	מציינים את השם של טבלה עם העמודות הבאות: id integer, bval blob, cval clob.
יומן	מחרוזת	לא נכון	קביעת רמת הרישום ביומן (verbosity) של חיבור. הרישום ביומן מופעל תמיד. רמות הרישום ביומן מפורטות בסדר עולה, מהרמה הכי תמציתית ועד לרמה הכי מפורטת.
log_data	מחרוזת	לא נכון	מציין נתונים נוספים שנדרשים למנגנון כניסה, כמו אסימון מאובטח, שם ייחודי או שם דומיין/תחום.
log_mech	מחרוזת	לא נכון	מציין את מנגנון הכניסה, שקובע את יכולות האימות וההצפנה של החיבור.
logon_sequence_number	מחרוזת	לא נכון	מציין מספר רצף כניסה (LSN) קיים שאליו יש לשייך את הסשן הזה.
max_message_body	מחרוזת	לא נכון	ההגדרה קובעת את הגודל המקסימלי של הודעת התשובה בבייטים.
maybe_null	מחרוזת	לא נכון	קובעת את ההתנהגות של השיטה ResultSetMetaData.isNullable.
new_password	מחרוזת	לא נכון	פרמטר החיבור הזה מאפשר לאפליקציה לשנות סיסמה שפג תוקפה באופן אוטומטי.
מחיצה	מחרוזת	לא נכון	מציינים את המחיצה במסד הנתונים של Teradata לחיבור.
prep_support	מחרוזת	לא נכון	מציינת אם מסד הנתונים של Teradata מבצע פעולת הכנה כשנוצר PreparedStatement או CallableStatement.
reconnect_count	מחרוזת	לא נכון	הגדרה שמאפשרת חיבור מחדש לסשן Teradata. מציינת את המספר המקסימלי של פעמים שבהן מנהל ההתקן Teradata JDBC ינסה להתחבר מחדש להפעלה.
reconnect_interval	מחרוזת	לא נכון	הגדרה שמאפשרת חיבור מחדש לסשן Teradata. מציין את מספר השניות שבהן מנהל ההתקן Teradata JDBC ימתין בין ניסיונות להתחבר מחדש להפעלה.
redrive	מחרוזת	לא נכון	האפשרות הזו מפעילה את התכונה 'חיבור מחדש של סשן Teradata', וגם מאפשרת הפעלה מחדש אוטומטית של בקשות SQL שהופסקו בגלל הפעלה מחדש של מסד הנתונים.
run_startup	מחרוזת	לא נכון	מציינים את הערך של RunStartup, ‏ ON או OFF.
סשנים	מחרוזת	לא נכון	מציין את מספר החיבורים של FastLoad או FastExport שייווצרו, כאשר 1 <= מספר החיבורים של FastLoad או FastExport <= מספר ה-AMP.
sip_support	מחרוזת	לא נכון	ההגדרה קובעת אם Teradata Database ו-Teradata JDBC Driver משתמשים ב-StatementInfo Parcel ‏ (SIP) כדי להעביר מטא-נתונים.
slob_receive_threshold	מחרוזת	לא נכון	המאפיין הזה קובע את הגודל המינימלי של ערכי LOB שמתקבלים ממסד הנתונים של Teradata. ערכים קטנים של LOB נטענים מראש ממסד הנתונים של Teradata לפני שהאפליקציה קוראת נתונים באופן מפורש מאובייקטים של Blob או Clob.
slob_transmit_threshold	מחרוזת	לא נכון	המאפיין הזה קובע איך ערכי LOB קטנים מועברים למסד הנתונים של Teradata.
sp_spl	מחרוזת	לא נכון	ההגדרה הזו מציינת את ההתנהגות של יצירה או החלפה של נהלים מאוחסנים ב-Teradata.
strict_encode	מחרוזת	לא נכון	מציין את ההתנהגות של קידוד נתוני תווים להעברה למסד הנתונים של Teradata.
tmode	מחרוזת	לא נכון	קביעת מצב הטרנזקציה של החיבור.
tnano	מחרוזת	לא נכון	מציין את רמת הדיוק של השניות החלקיות לכל הערכים של java.sql.Time שקשורים ל-PreparedStatement או ל-CallableStatement ומועברים ל-Teradata Database כערכים של TIME או TIME WITH TIME ZONE.
tsnano	מחרוזת	לא נכון	הפרמטר הזה מציין את רמת הדיוק של השניות החלקיות לכל הערכים של java.sql.Timestamp שקשורים ל-PreparedStatement או ל-CallableStatement ומועברים ל-Teradata Database כערכים של TIMESTAMP או TIMESTAMP WITH TIME ZONE.
tcp	מחרוזת	לא נכון	מציינת הגדרות אחת או יותר של שקע TCP, מופרדות באמצעות סימני פלוס (+).
trusted_sql	מחרוזת	לא נכון	מציינים את הערך של TrustedSql.
סוג	מחרוזת	לא נכון	מציינת את סוג הפרוטוקול שבו יש להשתמש עם מסד הנתונים של Teradata עבור הצהרות SQL.
upper_case_identifiers	בוליאני	לא נכון	בנכס הזה, כל המזהים מדווחים באותיות רישיות. זוהי ברירת המחדל למסדי נתונים של Oracle, ולכן היא מאפשרת שילוב טוב יותר עם כלים של Oracle, כמו Oracle Database Gateway.
use_xviews	מחרוזת	לא נכון	מציין אילו תצוגות של מילון הנתונים צריך לשאול כדי להחזיר קבוצות תוצאות משיטות DatabaseMetaData.

שימוש בחיבור Teradata בשילוב

אחרי שיוצרים את החיבור, הוא זמין גם ב-Apigee Integration וגם ב-Application Integration. אפשר להשתמש בחיבור בשילוב באמצעות המשימה Connectors.

• כדי להבין איך ליצור ולהשתמש במשימה Connectors ב-Apigee Integration, אפשר לעיין במאמר משימת Connectors.
• מידע על יצירה ושימוש במשימת מחברים ב-Application Integration זמין במאמר משימת מחברים.

קבלת עזרה מקהילת Google Cloud

אתם יכולים לפרסם את השאלות שלכם ולדון במחבר הזה בקהילת Google Cloud בפורומים של Cloud.

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

• איך משעים ומחדשים חיבור
• איך עוקבים אחרי השימוש בכלי לחיבור נתונים
• איך צופים ביומני המחברים