‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

Oracle DB (גרסה 2)

מחבר Oracle DB מאפשר לכם להתחבר למופע של מסד נתונים של Oracle ולבצע את פעולות מסד הנתונים הנתמכות.

גרסאות נתמכות

הגרסה המינימלית הנתמכת של המחבר הזה היא Oracle database version 11.2.

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

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

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

הגדרת המחבר

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

במסוף Cloud, עוברים לדף Integration Connectors > Connections ובוחרים או יוצרים פרויקט בענן.
כניסה לדף Connections
לוחצים על + יצירת חיבור חדש כדי לפתוח את הדף יצירת חיבור.
בקטע מיקום, בוחרים את המיקום של החיבור.
1. אזור: בוחרים מיקום מהרשימה הנפתחת.
  רשימה של כל האזורים הנתמכים מופיעה במאמר מיקומים.
2. לוחצים על הבא.
בקטע פרטי החיבור, ממלאים את הפרטים הבאים:
1. מחבר: בוחרים באפשרות Oracle DB מהרשימה הנפתחת של המחברים הזמינים.
2. גרסת המחבר: בוחרים בגרסה 2 מהרשימה הנפתחת של הגרסאות הזמינות.
3. בשדה Connection Name (שם החיבור), מזינים שם למופע החיבור.
  השמות של החיבורים צריכים לעמוד בקריטריונים הבאים:
  - שמות החיבורים יכולים לכלול אותיות, מספרים או מקפים.
  - האותיות צריכות להיות קטנות.
  - שמות החיבורים צריכים להתחיל באות ולהסתיים באות או במספר.
  - שמות החיבורים לא יכולים לכלול יותר מ-49 תווים.
4. אופציונלי: מזינים תיאור למופע החיבור.
5. אופציונלי: מפעילים את Cloud Logging ואז בוחרים רמת יומן. כברירת מחדל, רמת היומן מוגדרת כ-Error.
6. אפשר גם לבחור באפשרות הפעלה של Cloud Logging כדי להפעיל את Cloud Logging.
7. חשבון שירות: בוחרים חשבון שירות שיש לו את התפקידים הנדרשים.
8. אופציונלי: מגדירים את ההגדרות של צומת החיבור:
  - מספר מינימלי של צמתים: מזינים את המספר המינימלי של צמתי חיבור.
  - מספר הצמתים המקסימלי: מזינים את מספר צמתי החיבור המקסימלי.
  צומת הוא יחידה (או עותק) של חיבור שמבצעת עיבוד של עסקאות. כדי לעבד יותר עסקאות לחיבור נדרשים יותר צמתים, ולהפך: כדי לעבד פחות עסקאות נדרשים פחות צמתים. כדי להבין איך הצמתים משפיעים על התמחור של המחבר, אפשר לעיין במאמר בנושא תמחור של צמתי חיבור. אם לא מזינים ערכים, כברירת מחדל, מספר הצמתים המינימלי מוגדר כ-2 (לזמינות טובה יותר) ומספר הצמתים המקסימלי מוגדר כ-50.
9. בהתאם לסוג החיבור למסד הנתונים של Oracle (חיבור מבוסס-שרת או חיבור TNS), מציינים את ServiceName או את DataSource (מחרוזת חיבור TNS). אם תציינו את שניהם, המערכת תשתמש ב-DataSource.
  - ‫ServiceName: אם אתם משתמשים באימות מבוסס-שרת, צריך לציין את שם השירות יחד עם פרטי היעד.
  - ‫DataSource: אם משתמשים בקישוריות TNS, צריך לציין את השם של Oracle Net Services, את Connect Descriptor (שנקרא גם TNS connect string) או שם חיבור פשוט שמזהה את מסד הנתונים שאליו רוצים להתחבר. כדי לציין את מחרוזת החיבור של TNS, צריך להשתמש בפורמט הבא: (DESCRIPTION=(ADDRESS=(protocol_address_information))(CONNECT_DATA= (SERVICE_NAME=service_name))). אם מציינים את מקור הנתונים, אסור לציין שוב את פרטי היעד בקטע יעדים.
10. אפשר גם לבחור באפשרות Include Synonyms (הכללת מילים נרדפות).
11. זמן קצוב לתפוגה של חיבורים שהוצאו ממאגר: מזינים את ערך הזמן הקצוב לתפוגה (בשניות) שמציין כמה זמן חיבור שהוצא ממאגר יכול להישאר ללא שימוש לפני שהוא נחשב כחיבור שהוצא ממאגר ולא נעשה בו שימוש.
12. זמן קצוב לתפוגה של חיבור לא פעיל: מזינים את הערך של הזמן הקצוב לתפוגה של החיבור (בשניות).
13. זמן מקסימלי לשימוש חוזר בחיבור: מזינים את הזמן לשימוש חוזר בחיבור (בשניות).
14. זמן קצוב לתפוגה של חיבור: מזינים את הזמן המקסימלי (בשניות) שבו החיבור יכול להישאר בשימוש.
15. סכימות שאפשר לעיין בהן: מזינים את שמות הסכימות שמופרדים באמצעות פסיקים, שבהן רוצים להשתמש כשמאחזרים ישויות ופעולות. לדוגמה, schemaA, schemaB, schemaC.
16. אופציונלי: לוחצים על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
17. לוחצים על הבא.
בקטע יעדים, מזינים את הפרטים של המארח המרוחק (מערכת העורף) שאליו רוצים להתחבר.
1. סוג היעד: בוחרים סוג יעד.
  - כדי לציין את שם המארח או את כתובת ה-IP של היעד, בוחרים באפשרות כתובת המארח ומזינים את הכתובת בשדה מארח 1.
  - כדי ליצור חיבור פרטי, בוחרים באפשרות Endpoint attachment (צירוף נקודת קצה). ברשימה Endpoint Attachment, בוחרים את קובץ ה-Endpoint Attachment שנוצר עבור מערכת ה-Backend.
  אם רוצים ליצור חיבור ציבורי למערכות העורפיות עם אבטחה נוספת, אפשר להגדיר כתובות IP סטטיות יוצאות לחיבורים, ואז להגדיר את כללי חומת האש כך שרק כתובות ה-IP הסטטיות הספציפיות יופיעו ברשימת ההיתרים.
  
  כדי להזין יעדים נוספים, לוחצים על +הוספת יעד.
2. לוחצים על הבא.
בקטע אימות, מזינים את פרטי האימות.
1. בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.
  החיבור למסד הנתונים של Oracle תומך בסוגי האימות הבאים:
  - שם משתמש וסיסמה
2. לוחצים על הבא.
בדיקה: בודקים את פרטי החיבור והאימות.
לוחצים על יצירה.

הגדרת אימות

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

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

סוג החיבור לאימות בסיסי ב-Oracle DB

בטבלה הבאה מפורטים השדות שאפשר להגדיר עבור סוג החיבור של אימות בסיסי ב-Oracle DB.

שם השדה	פרטים
מיקום	us-central1
מחבר	Oracle DB
גרסת המחבר	2
שם החיבור	google-oracledb-plsql-new
הפעלת Cloud Logging	כן
חשבון השירות	SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
שם השירות	pdb1
מספר הצמתים המינימלי	2
מספר הצמתים המקסימלי	50
כתובת המארח	198.51.100.0
יציאה	1521
שם משתמש	שם משתמש
סיסמה	PASSWORD
גרסה של סוד	1

סוג החיבור Oracle DB TNS

בטבלה הבאה מתוארים השדות שאפשר להגדיר עבור סוג החיבור Oracle DB TNS.

שם השדה	פרטים
מיקום	us-central1
מחבר	Oracle DB
גרסת המחבר	2
שם החיבור	google-oracledb-plsql-tns
הפעלת Cloud Logging	כן
חשבון השירות	SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
מקור נתונים	(DESCRIPTION=(ADDRESS=(PROTOCOL_ADDRESS_INFORMATION))(CONNECT_DATA= (SERVICE_NAME=service_name)))
מספר הצמתים המינימלי	2
מספר הצמתים המקסימלי	50
שם משתמש	שם משתמש
סיסמה	PASSWORD
גרסה של סוד	1

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

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

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

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

מחבר Oracle DB יכול לעבד עד 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 מותאמות אישית, המחבר מספק את הפעולה Execute custom query (הרצת שאילתה מותאמת אישית).

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

פועלים לפי ההוראות המפורטות ל הוספת משימה של מחברים.
כשמגדירים את משימת המחבר, בוחרים באפשרות פעולות בסוג הפעולה שרוצים לבצע.
ברשימה Action, בוחרים באפשרות Execute custom query ולוחצים על Done.
מרחיבים את הקטע 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. כדי להוסיף כמה פרמטרים, לוחצים על + הוספת פרמטר של שאילתה.

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

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

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

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

בתיבת הדו-שיח Configure connector task (הגדרת משימת מחבר), בוחרים באפשרות Actions (פעולות).
בוחרים בפעולה Execute custom query (הפעלת שאילתה בהתאמה אישית) ואז לוחצים על Done (סיום).
בקטע Task Input (קלט משימה) של המשימה Connectors (מחברים), לוחצים על Edit Custom Query (עריכת שאילתה בהתאמה אישית). תיפתח תיבת הדו-שיח שאילתה בהתאמה אישית.
בתיבת הדו-שיח שאילתה מותאמת אישית, מזינים את שאילתת ה-SQL הבאה ולוחצים על שמירה:
```
      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 של משימת המחבר יכיל את קבוצת התוצאות של השאילתה.

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

בתיבת הדו-שיח Configure connector task (הגדרת משימת מחבר), בוחרים באפשרות Actions (פעולות).
בוחרים בפעולה Execute custom query (הפעלת שאילתה בהתאמה אישית) ואז לוחצים על Done (סיום).
בקטע Task Input (קלט של המשימה) במשימה Connectors (מחברים), מגדירים את הערכים הבאים בשדה:
1. Timeout after: 10
2. מספר השורות המקסימלי: 3
לוחצים על +הוספת שם פרמטר כדי להזין את הערכים הבאים:
1. סוג: VARCHAR
2. ערך: John
לוחצים על עריכת שאילתה מותאמת אישית. תיפתח תיבת הדו-שיח שאילתה בהתאמה אישית.

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

  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=?

בדוגמה הזו נבחרו רשומות של עובדים שבהן שם העובד הוא John. שימו לב שהשם של העובד מוגדר כפרמטר. אם הפעולה מצליחה, לפרמטר 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
}]

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

בתיבת הדו-שיח Configure connector task (הגדרת משימת מחבר), בוחרים באפשרות Actions (פעולות).
בוחרים בפעולה Execute custom query (הפעלת שאילתה בהתאמה אישית) ואז לוחצים על Done (סיום).
בתיבת הדו-שיח שאילתה מותאמת אישית, מזינים את שאילתת ה-SQL הבאה ולוחצים על שמירה:
```
  INSERT INTO AUTHOR(id,title) VALUES(author_table_id_seq.NEXTVAL,'Sample_book_title')
```

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

[{
}]

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

בתיבת הדו-שיח Configure connector task (הגדרת משימת מחבר), בוחרים באפשרות Actions (פעולות).
בוחרים בפעולה Execute custom query (הפעלת שאילתה בהתאמה אישית) ואז לוחצים על Done (סיום).
בתיבת הדו-שיח שאילתה מותאמת אישית, מזינים את שאילתת ה-SQL הבאה ולוחצים על שמירה:
```
  SELECT SUM(SALARY) as Total FROM EMPLOYEES
  
```

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

[{
"TOTAL": 13000.0
}]

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

בתיבת הדו-שיח Configure connector task (הגדרת משימת מחבר), בוחרים באפשרות Actions (פעולות).
בוחרים בפעולה Execute custom query (הפעלת שאילתה בהתאמה אישית) ואז לוחצים על Done (סיום).
בתיבת הדו-שיח שאילתה מותאמת אישית, מזינים את שאילתת ה-SQL הבאה ולוחצים על שמירה:
```
    CREATE TABLE TEST1 (ID INT, NAME VARCHAR(40),DEPT VARCHAR(20),CITY VARCHAR(10))
 
```

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

[{
}]

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

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

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

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

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

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

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

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

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

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות Employee מהרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.
בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value:
```
{
"EMPLOYEE_ID": 69.0,
"EMPLOYEE_NAME": "John",
"CITY": "Bangalore"
}
```
אם השילוב יצליח, בשדה connectorOutputPayload של משימת המחבר יופיע ערך שדומה לערך הבא:
```
 {
"ROWID": "AAAoU0AABAAAc3hAAF"
}
```

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

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

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות Employee מהרשימה Entity.
בוחרים את הפעולה Update ולוחצים על סיום.
בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך שדומה לערך הבא בשדה Default Value:
```
{
"EMPLOYEE_NAME": "John",
"CITY": "Mumbai"
}
```
לוחצים על entityId ואז מזינים 69 בשדה ערך ברירת מחדל.
לחלופין, במקום לציין את entityId, אפשר גם להגדיר את filterClause ל-69.

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

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

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

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

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

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

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

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

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

שם הפרמטר	סוג נתונים	חובה	תיאור
service_name	מחרוזת	לא נכון	שם השירות של מסד הנתונים של Oracle.
data_source	מחרוזת	לא נכון	שם שירות Oracle Net, תיאור חיבור (שנקרא גם מחרוזת חיבור TNS) או שם חיבור פשוט שמזהה את מסד הנתונים שאליו רוצים להתחבר.
include_synonyms	בוליאני	לא נכון	שליחת שאילתת מטא-נתונים למילים נרדפות והפיכתן לזמינות כישויות. הגדרת הנכס ל-false יכולה לשפר את הביצועים של המטא-נתונים.
abandoned_connection_timeout	מספר שלם	לא נכון	הזמן הקצוב לתפוגה של חיבור שננטש (בשניות) קובע כמה זמן חיבור מושאל יכול להישאר ללא שימוש לפני שהוא נחשב כחיבור שננטש ומוחזר למאגר החיבורים.
inactive_connection_timeout	מספר שלם	לא נכון	הזמן הקצוב לתפוגה של חיבור לא פעיל (בשניות) קובע כמה זמן חיבור זמין נשאר במאגר החיבורים לפני שהוא מוסר מהמאגר.
max_connection_reuse_time	מספר שלם	לא נכון	הזמן המקסימלי לשימוש חוזר בחיבור (בשניות) מציין את הזמן המקסימלי שבו אפשר להשתמש בחיבור, ולאחר מכן המאגר מסיר וסוגר את החיבור.
ttl_connection_timeout	מספר שלם	לא נכון	הזמן המקסימלי (בשניות) שחיבור יכול להיות בשימוש.
browsable_schemas	מחרוזת	לא נכון	סכימות מופרדות בפסיקים (למשל, ‫SchemaA, ‏ SchemaB) לשימוש באחזור ישויות ופעולות לחיבור. שימוש בסכימת המשתמש כברירת מחדל

שימוש בחיבור למסד הנתונים של Oracle בשילוב

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

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

מגבלות ידועות

מחבר Application Integration של Oracle לא תומך ב-Oracle Single Client Access Name (שם גישה יחיד ללקוח,‏ SCAN) כי התשתית הבסיסית שלו לא יכולה לעבד את מנגנון ההפניה האוטומטית של כתובות IP, וכתוצאה מכך יש כשלים לסירוגין בקישוריות וזמן קצוב לתפוגה של java.lang.IllegalStateException.

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

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