‫SAP ASE (Sybase)

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

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

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

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

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

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

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

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

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

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

1. בתיבת הדו-שיח Configure Connector, בוחרים באפשרות Region, Connection and Actions.
2. בוחרים באפשרות Execute Custom Query מתוך הפעולות ולוחצים על סיום.
3. בקטע Task Input (קלט משימה) של Connector (כלי לחיבור), לוחצים על Edit Custom Script ואז מזינים ערך דומה לערך הבא בשדה Custom Query:

   CREATE TABLE customqueries98(
        ID   INT ,
        NAME VARCHAR (20),
        AGE  INT,
        City  CHAR (25) ,
        SALARY   DECIMAL (18, 2)  );

בדוגמה הזו מוצג איך להריץ שאילתה בהתאמה אישית כדי ליצור טבלה חדשה. אם הפעולה מצליחה, פרמטר התגובה של משימת Execute Custom Query connectorOutputPayload מחזיר מטען ייעודי ריק.

דוגמה – שינוי טבלה

1. בתיבת הדו-שיח Configure Connector, בוחרים באפשרות Region, Connection and Actions.
2. בוחרים באפשרות Execute Custom Query מתוך הפעולות ולוחצים על סיום.
3. בקטע Task Input (קלט משימה) של Connector (כלי לחיבור), לוחצים על Edit Custom Script ואז מזינים ערך דומה לערך הבא בשדה Custom Query:

   ALTER TABLE customqueries98 ADD CONSTRAINT ID PRIMARY KEY (ID)

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

דוגמה – חיתוך טבלה

1. בתיבת הדו-שיח Configure Connector, בוחרים באפשרות Region, Connection and Actions.
2. בוחרים באפשרות Execute Custom Query מתוך הפעולות ולוחצים על סיום.
3. בקטע Task Input (קלט משימה) של Connector (כלי לחיבור), לוחצים על Edit Custom Script ואז מזינים ערך דומה לערך הבא בשדה Custom Query:

   TRUNCATE TABLE customqueries99

בדוגמה הזו מוצגת הפעולה Execute Custom Query (הפעלת שאילתה בהתאמה אישית) לקיצוץ טבלה. אם הפעולה מצליחה, פרמטר התגובה connectorOutputPayload של המשימה Execute Custom Query מחזיר מטען ייעודי (payload) ריק.

דוגמה – הסרת טבלה

1. בתיבת הדו-שיח Configure Connector, בוחרים באפשרות Region, Connection and Actions.
2. בוחרים באפשרות Execute Custom Query מתוך הפעולות ולוחצים על סיום.
3. בקטע Task Input (קלט משימה) של Connector (כלי לחיבור), לוחצים על Edit Custom Script ואז מזינים ערך דומה לערך הבא בשדה Custom Query:

   DROP TABLE customqueries99

בדוגמה הזו מוצגת הפעלה של שאילתה בהתאמה אישית כדי להסיר טבלה. אם הפעולה מצליחה, פרמטר התגובה של משימת Execute Custom Query connectorOutputPayload מחזיר מטען ייעודי ריק.

דוגמה – אימות של SUM

1. בתיבת הדו-שיח Configure Connector, בוחרים באפשרות Region, Connection and Actions.
2. בוחרים באפשרות Execute Custom Query מתוך הפעולות ולוחצים על סיום.
3. בקטע Task Input (קלט משימה) של Connector (כלי לחיבור), לוחצים על Edit Custom Script ואז מזינים ערך דומה לערך הבא בשדה Custom Query:

   SELECT SUM(SALARY) as Total FROM EMPLOYEES

בדוגמה הזו מוצגת הפונקציה Execute Custom Query (הפעלת שאילתה בהתאמה אישית) כדי לאמת את הסכום של הפונקציה Aggregate (צבירה). אם הפעולה מצליחה, ערך הפרמטר Execute Custom Query response connectorOutputPayload של המשימה יהיה דומה לדוגמה הבאה:

[{
  "Total": 7500.0
  }] 

דוגמה – אימות של AVG

1. בתיבת הדו-שיח Configure Connector, בוחרים באפשרות Region, Connection and Actions.
2. בוחרים באפשרות Execute Custom Query מתוך הפעולות ולוחצים על סיום.
3. בקטע Task Input (קלט משימה) של Connector (כלי לחיבור), לוחצים על Edit Custom Script ואז מזינים ערך דומה לערך הבא בשדה Custom Query:

   SELECT AVG(SALARY) as Average FROM EMPLOYEES

בדוגמה הזו מוצגת הפונקציה Execute Custom Query (הפעלת שאילתה בהתאמה אישית) כדי לאמת את הפונקציה AVG of Aggregate (ממוצע של פונקציית צבירה). אם הפעולה מצליחה, ערך הפרמטר Execute Custom Query response connectorOutputPayload של המשימה יהיה דומה לדוגמה הבאה:

[{
  "Average": 7500.0
  }] 

דוגמה – אימות של MAX

1. בתיבת הדו-שיח Configure Connector, בוחרים באפשרות Region, Connection and Actions.
2. בוחרים באפשרות Execute Custom Query מתוך הפעולות ולוחצים על סיום.
3. בקטע Task Input (קלט משימה) של Connector (כלי לחיבור), לוחצים על Edit Custom Script ואז מזינים ערך דומה לערך הבא בשדה Custom Query:

   SELECT MAX(SALARY) as Max_Salary FROM EMPLOYEES

בדוגמה הזו מוצגת הפעלה של שאילתה מותאמת אישית כדי לאמת את הפונקציה MAX של פונקציית צבירה. אם הפעולה מצליחה, ערך הפרמטר Execute Custom Query response connectorOutputPayload של המשימה יהיה דומה לדוגמה הבאה:

[{
  "Max_Salary": 7500.0
  }] 

דוגמה – אימות מספר טלפון

1. בתיבת הדו-שיח Configure Connector, בוחרים באפשרות Region, Connection and Actions.
2. בוחרים באפשרות Execute Custom Query מתוך הפעולות ולוחצים על סיום.
3. בקטע Task Input (קלט משימה) של Connector (כלי לחיבור), לוחצים על Edit Custom Script ואז מזינים ערך דומה לערך הבא בשדה Custom Query:

   SELECT MIN(SALARY) as Min_Salary FROM EMPLOYEES

בדוגמה הזו מוצגת הפונקציה Execute Custom Query (הפעלת שאילתה בהתאמה אישית) כדי לאמת את הפונקציה MIN of Aggregate (מינימום של פונקציית צבירה). אם הפעולה מצליחה, ערך הפרמטר Execute Custom Query response connectorOutputPayload של המשימה יהיה דומה לדוגמה הבאה:

[{
  "Min_Salary": 7500.0    
  }]

דוגמה – אימות של COUNT

1. בתיבת הדו-שיח Configure Connector, בוחרים באפשרות Region, Connection and Actions.
2. בוחרים באפשרות Execute Custom Query מתוך הפעולות ולוחצים על סיום.
3. בקטע Task Input (קלט משימה) של Connector (כלי לחיבור), לוחצים על Edit Custom Script ואז מזינים ערך דומה לערך הבא בשדה Custom Query:

   select count(*) from EMPLOYEES

בדוגמה הזו מוצגת הפונקציה Execute Custom Query (הפעלת שאילתה בהתאמה אישית) לאימות הפונקציה Count of Aggregate (ספירה של פונקציית צבירה). אם הפעולה מצליחה, ערך הפרמטר Execute Custom Query response connectorOutputPayload של המשימה יהיה דומה לדוגמה הבאה:

[{
  "": 1.0
  }]

דוגמה – שימוש ב-Join וב-GroupBy

1. בתיבת הדו-שיח Configure Connector, בוחרים באפשרות Region, Connection and Actions.
2. בוחרים באפשרות Execute Custom Query מתוך הפעולות ולוחצים על סיום.
3. בקטע Task Input (קלט משימה) של Connector (כלי לחיבור), לוחצים על Edit Custom Script ואז מזינים ערך דומה לערך הבא בשדה Custom Query:

   SELECT SmallMoney.amount, Sum(Testsybase.clone) AS Total
     FROM Testsybase
     INNER JOIN SmallMoney
     ON Testsybase.id = SmallMoney.id
     GROUP BY SmallMoney.amount;

בדוגמה הזו מוצגת הפעלה של שאילתה בהתאמה אישית באמצעות Join ו-GroupBy. אם הפעולה מצליחה, ערך הפרמטר Execute Custom Query response connectorOutputPayload של המשימה יהיה דומה לדוגמה הבאה:

[{
    "amount": 1122.56,
    "Total": 14.0
  }, {
    "amount": 123.4567,
    "Total": 11.0
  }, {
    "amount": 1123.45,
    "Total": 13.0
  }]

דוגמה – שימוש בפרמטרים של שאילתה וב-Join

1. בתיבת הדו-שיח Configure Connector, בוחרים באפשרות Region, Connection and Actions.
2. בוחרים באפשרות Execute Custom Query מתוך הפעולות ולוחצים על סיום.
3. בקטע Task Input (קלט משימה) של Connector (כלי לחיבור), לוחצים על Edit Custom Script ואז מזינים ערך דומה לערך הבא בשדה Custom Query:

   SELECT e.payload,e.rest,ed.id FROM Testsybase e, Smallmoney ed where e.id=ed.id and ed.id=?

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

 [{
    "payload": 5678.9,
    "rest": 13.6666,
    "id": 2.0
  }] 

דוגמה – שימוש בפונקציות GroupBy, ‏ Having ו-Count

1. בתיבת הדו-שיח Configure Connector, בוחרים באפשרות Region, Connection and Actions.
2. בוחרים באפשרות Execute Custom Query מתוך הפעולות ולוחצים על סיום.
3. בקטע Task Input (קלט משימה) של Connector (כלי לחיבור), לוחצים על Edit Custom Script ואז מזינים ערך דומה לערך הבא בשדה Custom Query:

   select payload, count(payload) from Testsybase group by payload having count(payload)>=1

בדוגמה הזו מוצגת הפעלה של שאילתה מותאמת אישית באמצעות GroupBy, ‏ Having ו-Count. אם הפעולה מצליחה, ערך הפרמטר Execute Custom Query response connectorOutputPayload של המשימה יהיה דומה לדוגמה הבאה:

[{
    "payload": 1234.56,
    "": 1.0
  }, {
    "payload": 2345.67,
    "": 1.0
  }, {
    "payload": 4352.78,
    "": 1.0
  }, {
    "payload": 6789.12,
    "": 1.0
  }]

דוגמה – שימוש ב-Column Cast, ב-LIKE ובאופרטורים אחרים

1. בתיבת הדו-שיח Configure Connector, בוחרים באפשרות Region, Connection and Actions.
2. בוחרים באפשרות Execute Custom Query מתוך הפעולות ולוחצים על סיום.
3. בקטע Task Input (קלט משימה) של Connector (כלי לחיבור), לוחצים על Edit Custom Script ואז מזינים ערך דומה לערך הבא בשדה Custom Query:

   select e.id,e.clone from Testsybase e where e.payload>10 and e.rest LIKE '%1%' AND e.id<>3 order by e.id;

בדוגמה הזו מוצגת הפעלה של שאילתה בהתאמה אישית באמצעות Column Cast,‏ LIKE ואופרטורים אחרים, כמו <>‎. אם הפעולה בוצעה בהצלחה, לפרמטר התגובה connectorOutputPayload של משימת Execute Custom Query יהיה ערך שדומה לערך הבא:

[{
    "id": 1.0,
    "clone": 10.0
  }, {
    "id": 2.0,
    "clone": 99.0
  }, {
    "id": 4.0,
    "clone": 14.0
  }]

דוגמה – הפעלת פונקציה על ידי הזנת קלט בשילוב

1. בתיבת הדו-שיח Configure Connector, בוחרים באפשרות Region, Connection and Actions.
2. בוחרים באפשרות Execute Custom Query מתוך הפעולות ולוחצים על סיום.
3. בקטע Task Input (קלט משימה) של Connector (כלי לחיבור), לוחצים על Edit Custom Script ואז מזינים ערך דומה לערך הבא בשדה Custom Query:

   SELECT dbo.MultiplyNumbers(5, 10) AS Result

בדוגמה הזו מוצגת הפעולה Execute Custom Query (הפעלת שאילתה בהתאמה אישית) להפעלת פונקציה על ידי הזנת קלט בשילוב. אם הפעולה מצליחה, ערך הפרמטר Execute Custom Query response connectorOutputPayload של המשימה יהיה דומה לדוגמה הבאה:

 [{
    "Result": 50.0
  }] 

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

1. בתיבת הדו-שיח Configure Connector, בוחרים באפשרות Region, Connection and Actions.
2. בוחרים באפשרות Execute Custom Query מתוך הפעולות ולוחצים על סיום.
3. בקטע Task Input (קלט משימה) של Connector (כלי לחיבור), לוחצים על Edit Custom Script ואז מזינים ערך דומה לערך הבא בשדה Custom Query:

   CREATE FUNCTION MultiplyNumbersTest1
     (@num1 INT, @num2 INT) 
     RETURNS INT AS RETURN @num1 * @num2

בדוגמה הזו רואים איך להשתמש בפעולה Execute Custom Query (הפעלת שאילתה בהתאמה אישית) כדי ליצור פונקציה על ידי הזנת קלט בשילוב. אם הפעולה מצליחה, פרמטר התגובה של משימת Execute Custom Query connectorOutputPayload מחזיר מטען ייעודי ריק.

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

1. בתיבת הדו-שיח Configure Connector, בוחרים באפשרות Region, Connection and Actions.
2. בוחרים באפשרות Execute Custom Query מתוך הפעולות ולוחצים על סיום.
3. בקטע מיפוי נתונים, לוחצים על Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:

   {
     "@EmpID": 1.0
     } 
     

בדוגמה הזו מוצג Execute Custom Query (הפעלת שאילתה בהתאמה אישית) להפעלת פרוצדורה על ידי הזנת קלט מסוים בשילוב. אם הפעולה מצליחה, ערך הפרמטר Execute Custom Query response connectorOutputPayload של המשימה יהיה דומה לדוגמה הבאה:

 [{
    "EmpID": 1.0,
    "LastName": "Test",
    "FirstName": "Bcone",
    "Address": "Noida",
    "City": "UP"
  }] 
  

דוגמה – יצירת הליך על ידי הזנת נתוני קלט בשילוב

1. בתיבת הדו-שיח Configure Connector, בוחרים באפשרות Region, Connection and Actions.
2. בוחרים באפשרות Execute Custom Query מתוך הפעולות ולוחצים על סיום.
3. בקטע Task Input (קלט משימה) של Connector (כלי לחיבור), לוחצים על Edit Custom Script ואז מזינים ערך דומה לערך הבא בשדה Custom Query:

   CREATE PROCEDURE SelectAllEmployees2 @EmpID int
     AS
     SELECT * FROM Employees WHERE EmpID = @EmpID

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

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

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

דוגמה – הצגת כל הרשומות

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות numbers_table מהרשימה Entity.
3. בוחרים את הפעולה List ולוחצים על סיום.

דוגמה – אחזור רשומה מישות

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות numbers_table מהרשימה Entity.
3. בוחרים את הפעולה Get ולוחצים על סיום.
4. מגדירים את מזהה הישות ל-Get single numbers_table. כדי להגדיר את מזהה הישות, בקטע Data Mapper (מיפוי נתונים) של Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor (פתיחת כלי מיפוי הנתונים), מזינים 1.0 בשדה Input Value (ערך קלט) ובוחרים באפשרות EntityId בתור Local variable (משתנה מקומי).

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

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות numbers_table מהרשימה Entity.
3. בוחרים את הפעולה Create ולוחצים על סיום.
4. בקטע Data mapper (מיפוי נתונים) של Task (משימה), לוחצים על OpenDataMapping editor (עורך) ומזינים ערך דומה לערך הבא ב-field:

   {
   "bigint_column": 1.2345678901234516E16,
   "usmallint_column": 124.0,
   "numeric_column": 987.664,
   "real_column": 67.88999938964847,
   "uint_column": 125.0,
   "ubigint_column": 1.2345678901234516E16,
   "decimal_column": 124.459,
   "smallint_column": 16.0,
   "int_column": 125.0,
   "floatn_column": 154.45,
   "tinyint_column": 127.0,
   "id": 20.0
   }

   הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

   {
   "Success": true 
   }
   

Example - Update a record

1. In the Configure connector task dialog, click Entities.
2. Select numbers_table from the Entity list.
3. Select the Update operation, and then click Done.
4. Set the entity ID to Update a numbers_table. To set the entity ID, in the Data mapper section of the Tasks, click entityId and then enter 20.0 in the given field.
5. In the Data mapper section of the Task click OpenDataMapping editor and then enter a value similar to the following in the field:

    
   {
   "uint_column": 128.0,
   "floatn_column": 154.95
   }

אם מריצים את הדוגמה הזו, מוחזר מטען ייעודי (payload) ריק.

דוגמה – מחיקת נתונים מטבלה

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות numbers_table מהרשימה Entity.
3. בוחרים את הפעולה Delete ולוחצים על סיום.
4. מגדירים את מזהה הישות ל-Delete numbers_table. כדי להגדיר את מזהה הישות, בקטע Data Mapper (מיפוי נתונים) של Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor (פתיחת כלי מיפוי הנתונים), מזינים 2.0 בשדה Input Value (ערך קלט) ובוחרים באפשרות EntityId בתור Local variable (משתנה מקומי).