SAP HANA

實體、作業和動作

所有整合連接器都會為所連應用程式的物件提供抽象層。您只能透過這個抽象化程序存取應用程式的物件。抽象化會以實體、作業和動作的形式呈現。

• 實體： 實體可以視為已連結應用程式或服務中的物件，或是屬性集合。實體的定義因連接器而異。舉例來說，在資料庫連接器中，資料表是實體；在檔案伺服器連接器中，資料夾是實體；在訊息系統連接器中，佇列是實體。

  不過，連接器可能不支援或沒有任何實體，在這種情況下，Entities 清單會是空白。

• 作業： 作業是指您可以在實體上執行的活動。您可以對實體執行下列任一操作：
  • 列出
  • 取得
  • 建立
  • 更新
  • 刪除

  從可用清單中選取實體，系統會產生該實體可用的作業清單。如需作業的詳細說明，請參閱 Connectors 工作的實體作業。 不過，如果連接器不支援任何實體作業，系統就不會在 Operations 清單中列出這些不支援的作業。

• 動作： 動作是透過連接器介面提供給整合的第一類函式。動作可讓您變更一或多個實體，且因連接器而異。一般來說，動作會有一些輸入參數和輸出參數。不過，連接器可能不支援任何動作，此時 Actions 清單會是空白。

動作

本節列出連接器支援的操作。如要瞭解如何設定動作，請參閱「動作範例」。

EMPLOYEE_PROCEDURE_HANA 動作

這項動作會傳回 ID 的資料。

EMPLOYEE_PROCEDURE_HANA 動作的輸入參數

如要瞭解如何設定 EMPLOYEE_PROCEDURE_HANA 動作，請參閱範例。

ExecuteCustomQuery 動作

這項操作可讓您執行特定工作。舉例來說，您可以在 HANADB 執行自訂 SQL 查詢。

ExecuteCustomQuery 動作的輸入參數

如要瞭解如何設定 ExecuteCustomQuery 動作，請參閱範例。

動作範例

範例 - EMPLOYEE_PROCEDURE_HANA

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 EMPLOYEE_PROCEDURE_HANA 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "ID":1
   }
   

如果動作成功，EMPLOYEE_PROCEDURE_HANA 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

 [{
"EMP_ID": 1.0,
"NAME": "Komal",
"CITY": "UP",
"SALARY": 7500.0,
"DEPARTMENT": "IT" 
}]

範例 - 執行 ExecuteCustomQuery Join_GroupBy

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 ExecuteCustomQuery 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "query": "SELECT CUSTOMER.COMPANY, SUM(ORDERS.AMOUNT) AS Total
   FROM ORDERS
   INNER JOIN CUSTOMER
   ON ORDERS.CUSTOMER_ID = CUSTOMER.ID
   GROUP BY CUSTOMER.COMPANY"
   }
   

如果動作成功，ExecuteCustomQuery 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

[{
"COMPANY": "google India",
"TOTAL": 1560.0
},{
"COMPANY": "IBM India",
"TOTAL": 4500.0
}]

範例 - 執行自訂查詢聯結

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 ExecuteCustomQuery 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "query": "SELECT ID, NAME, AGE, AMOUNT FROM CUSTOMERS JOIN ORDERS ON CUSTOMERS.ID = ORDERS.CUSTOMER_ID"
     }]
   }
   

如果動作成功，ExecuteCustomQuery 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

[{
  "ID": 3.0,
  "NAME": "Kaushik",
  "AGE": 23.0,
  "AMOUNT": 3000.0
}, {
  "ID": 3.0,
  "NAME": "Kaushik",
  "AGE": 23.0,
  "AMOUNT": 1500.0
}, {
  "ID": 2.0,
  "NAME": "Khilan",
  "AGE": 25.0,
  "AMOUNT": 1560.0
}, {
  "ID": 4.0,
  "NAME": "Chaitali",
  "AGE": 25.0,
  "AMOUNT": 2060.0
}]

範例 - 執行 CustomQuery Groupby_Having_Count

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 ExecuteCustomQuery 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "query": "SELECT COUNT(ID), CITY FROM GCP_HANA_CUSTOM GROUP BY CITY HAVING COUNT(ID) > 1"
   }
   

如果動作成功，ExecuteCustomQuery 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

 [{
  "COUNT(ID)": 2.0,
  "CITY": "Delhi"
}] 

範例 - 執行 ExecuteCustomQuery GroupBy

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 ExecuteCustomQuery 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "query": "SELECT COUNT(ID), CITY FROM GCP_HANA_CUSTOM GROUP BY CITY"
   }
   

這個範例會更新 ExecuteCustomQuery 記錄。如果動作成功，ExecuteCustomQuery 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

[{
  "COUNT(ID)": 1.0,
  "CITY": "Kolkata"
}, {
  "COUNT(ID)": 1.0,
  "CITY": "Katihar"
}, {
  "COUNT(ID)": 1.0,
  "CITY": "Bangalore"
}, {
  "COUNT(ID)": 2.0,
  "CITY": "Delhi"
}]

範例 - 執行 CustomQuery GroupBy_OrderBy

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 ExecuteCustomQuery 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "query": "SELECT COUNT(ID), CITY FROM GCP_HANA_CUSTOM GROUP BY CITY ORDER BY COUNT(ID) DESC"
   }
   

如果動作成功，ExecuteCustomQuery 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

[{
  "COUNT(ID)": 2.0,
  "CITY": "Delhi"
}, {
  "COUNT(ID)": 1.0,
  "CITY": "Kolkata"
}, {
  "COUNT(ID)": 1.0,
  "CITY": "Bangalore"
}, {
  "COUNT(ID)": 1.0,
  "CITY": "Katihar"
}]

範例 - 執行 ExecuteCustomQuery Insert_Table

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 ExecuteCustomQuery 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "query": "INSERT INTO CUSTOMER VALUES (3, 'IBM India')"
   }
   

如果動作成功，ExecuteCustomQuery 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

[{
}]

範例 - 執行 ExecuteCustomQuery SUM_AggFunc

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 ExecuteCustomQuery 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "query": "SELECT SUM(SALARY) FROM CUSTOMERS"
   }
   

如果動作成功，ExecuteCustomQuery 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

 [{
"SUM(SALARY)": 12000.0
}] 

範例 - 執行 ExecuteCustomQuery AVG_AggFunc

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 ExecuteCustomQuery 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "query": "SELECT AVG(SALARY) FROM CUSTOMERS"
   }
   

如果動作成功，ExecuteCustomQuery 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

[{
"AVG(SALARY)": 3000.0
}] 

範例 - 執行 MAX_AggFunc 自訂查詢

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 ExecuteCustomQuery 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "query": "SELECT MAX(SALARY) FROM CUSTOMERS"
   }
   

如果動作成功，ExecuteCustomQuery 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

 [{
"MAX(SALARY)": 6500.0
}] 

範例 - 執行 ExecuteCustomQuery MIN_AggFunc

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 ExecuteCustomQuery 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "query": "SELECT MIN(SALARY) FROM CUSTOMERS"
   }
   

如果動作成功，ExecuteCustomQuery 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

[{
"MIN_SALARY": 1500.0
}]

範例 - 執行 COUNT_AggFunc 自訂查詢

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 ExecuteCustomQuery 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "query": "SELECT COUNT(*) FROM CUSTOMERS"
   }
   

如果動作成功，ExecuteCustomQuery 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

[{
"COUNT(*)": 4.0
}]

範例 - ExecuteCustomQuery CreateTable

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 ExecuteCustomQuery 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "query": "CREATE TABLE CUSTOMER (ID INT NOT NULL,COMPANY VARCHAR (20))"
   }
   

如果動作成功，ExecuteCustomQuery 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

[{
}]

範例 - ExecuteCustomQuery AlterTable

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 ExecuteCustomQuery 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "query": "ALTER TABLE GCP_HANA_CUSTOM ADD CONSTRAINT test PRIMARY KEY (ID)"
   }
   

如果動作成功，ExecuteCustomQuery 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

[{
}]

範例 - 執行 ExecuteCustomQuery TruncateTable

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 ExecuteCustomQuery 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "query": "TRUNCATE TABLE GCP_HANA_RENAME"
   }
   

如果動作成功，ExecuteCustomQuery 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

[{
}]

範例 - 執行 ExecuteCustomQuery DropTable

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 ExecuteCustomQuery 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "query": "DROP TABLE GCP_HANA_DROP"
   }
   

如果動作成功，ExecuteCustomQuery 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

[{
}]

範例 - 執行 ExecuteCustomQuery RenameTable

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 ExecuteCustomQuery 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "query": "RENAME TABLE GCP_HANA_CUSTOM1 TO GCP_HANA_RENAME"
   }
   

如果動作成功，ExecuteCustomQuery 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

[{
}]

範例 - ExecuteCustomQuery UpdateTable

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 ExecuteCustomQuery 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "query": "UPDATE CUSTOMERS SET ADDRESS = 'Pune' WHERE ID = 3"
   }
   

如果動作成功，ExecuteCustomQuery 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

[{
}]

範例 - 執行 SELECT_DATA_Table 的 ExecuteCustomQuery

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 ExecuteCustomQuery 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "query": "SELECT * FROM CUSTOMERS"
   }
   

如果動作成功，ExecuteCustomQuery 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

[{
  "ID": 1.0,
  "NAME": "Ramesh",
  "AGE": 32.0,
  "ADDRESS": "Ahmedabad",
  "SALARY": 2000.0
}, {
  "ID": 2.0,
  "NAME": "Khilan",
  "AGE": 25.0,
  "ADDRESS": "Delhi",
  "SALARY": 1500.0
}, {
  "ID": 4.0,
  "NAME": "Chaitali",
  "AGE": 25.0,
  "ADDRESS": "Mumbai",
  "SALARY": 6500.0
}]

範例 - 執行 ExecuteCustomQuery DeleteTable

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 ExecuteCustomQuery 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "query": "DELETE FROM CUSTOMERS WHERE ID = 3"
   }
   

如果動作成功，ExecuteCustomQuery 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

[{
}]

實體作業範例

本節說明如何使用這個連接器執行部分實體作業。

範例 - 列出所有員工

這個範例會列出 Employee 實體中的所有員工。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Employee。
3. 選取「List」作業，然後按一下「完成」。
4. (選用) 在「連結器」工作的「工作輸入」部分，您可以指定篩選子句，篩選結果集。 請一律在單引號 (') 內指定篩選子句值，例如 City='Bangalore'。您也可以使用邏輯運算子指定多個篩選條件。例如：City='Bangalore' and region='asia-south2'。

範例 - 取得記錄

這個範例會從 Employee 實體取得具有指定 ID 的記錄。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Employee。
3. 選取「Get」作業，然後按一下「完成」。
4. 在「連線器」工作的「工作輸入」部分，按一下「EntityId」，然後在「預設值」欄位中輸入 12294。

   其中 12294 是 Employee 實體中的主鍵值。

範例 - 在 Hana_unicode 中建立記錄

這個範例會在 Hana_unicode 實體中建立記錄。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Hana_unicode。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "ID": 2.0,
   "UNICODEDATA": "Unicode データ型はグローバル化されたデータの保存に使用されます",
   "TEST": "Test7"
   }

   如果整合成功，連接器工作的 connectorOutputPayload 欄位會包含類似下列內容的值：

   {
   "ID": 2.0,
   "UNICODEDATA": "Unicode データ型はグローバル化されたデータの保存に使用されます",
   "TEST": "Test7"
   }

範例 - 在 Languages 中建立記錄

這個範例會在 Languages 實體中建立記錄。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Languages。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "ID": 5,
   "ARABICTEXT": "مرحبا",
   "GERMANTEXT": "Günther",
   "HINDITEXT": "नमस्ते",
   "ENGLISHTEST": "Test1"
   }

   如果整合成功，連接器工作的 connectorOutputPayload 欄位會包含類似下列內容的值：

   {
   "ID": 5.0,
   "ARABICTEXT": "مرحبا",
   "GERMANTEXT": "Günther",
   "HINDITEXT": "नमस्ते",
   "ENGLISHTEST": "Test1"
   }

範例 - 更新記錄

這個範例會更新 Employee 實體中的記錄。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Employee。
3. 選取「Update」作業，然後按一下「完成」。
4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "SALARY": 9000.0
   }

5. 按一下「entityId」，然後在「Default Value」欄位中輸入 12294。

   如果整合成功，連接器工作的 connectorOutputPayload 欄位會包含類似下列內容的值：

   {
   "SALARY": 9000.0
   }

範例 - 刪除記錄

這個範例會刪除 Employee 實體中具有指定 ID 的記錄。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Employee。
3. 選取「Delete」作業，然後按一下「完成」。
4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下「entityId」，然後在「Default Value」(預設值) 欄位中輸入 10001。