SAP HANA XS Advanced

您可以使用 SAP Hana XS Advanced 連接器，透過指定的 OData 服務執行讀取作業。

如要執行建立、更新和刪除作業，您必須在 SAP HANA XS Advanced 中，連線應用程式的 OData 服務中編寫自訂結束點。

支援的版本

以下是這個連接器支援的最低版本：

• SAP HANA 版本：HDB 2.00.078.00.1715149848
• XS Advanced 版本：1.2.2.240510120427

事前準備

使用 SAP Hana XSA 連接器前，請先完成下列工作：

• 在 Google Cloud 專案中：
  • 確認已設定網路連線。如要瞭解網路模式，請參閱「網路連線」。
  • 將 roles/connectors.admin IAM 角色授予設定連線器的使用者。
  • 將下列 IAM 角色授予要用於連接器的服務帳戶：
    • roles/secretmanager.viewer
    • roles/secretmanager.secretAccessor

    服務帳戶是特殊的 Google 帳戶類型，主要用於代表需要驗證且必須取得授權才能存取 Google API 資料的非人類使用者。如果您沒有服務帳戶，請務必建立服務帳戶。連接器和服務帳戶必須屬於同一個專案。詳情請參閱「建立服務帳戶」。

  • 啟用下列服務：
    • secretmanager.googleapis.com (Secret Manager API)
    • connectors.googleapis.com (Connectors API)

    如要瞭解如何啟用服務，請參閱「啟用服務」。

  如果專案先前未啟用這些服務或權限，系統會在設定連結器時提示您啟用。

如要瞭解如何建立 SAP HANA XS Advanced 應用程式，請參閱 SAP HANA Developer Guide for XS Advanced Model。 如要進一步瞭解 SAP HANA，請參閱 SAP HANA platform overview。

設定連接器

連線專屬於資料來源。也就是說，如果您有多個資料來源，則必須為每個資料來源建立個別的連線。如要建立連線，請按照下列步驟操作：

1. 在 Cloud 控制台中，前往「Integration Connectors」>「Connections」頁面，然後選取或建立 Google Cloud 專案。

   前往「Connections」(連線) 頁面

2. 按一下「+ 建立新連線」，開啟「建立連線」頁面。
3. 在「位置」部分中，選擇連線位置。
   1. 區域：從下拉式清單中選取位置。

      如需所有支援的地區清單，請參閱「位置」一文。

   2. 點按「下一步」。
4. 在「連線詳細資料」部分，完成下列步驟：
   1. 連接器：從可用連接器的下拉式清單中選取「SAP HANA XS Advanced」。
   2. 連接器版本：從可用版本的下拉式清單中選取連接器版本。
   3. 在「連線名稱」欄位中，輸入連線執行個體的名稱。

      連線名稱必須符合下列條件：

      • 連線名稱可使用英文字母、數字或連字號。
      • 字母必須為小寫。
      • 連線名稱開頭須為英文字母，結尾則須為英文字母或數字。
      • 連結名稱不得超過 49 個字元。
   4. 視需要輸入連線執行個體的「Description」(說明)。
   5. 或者，可啟用 Cloud Logging，然後選取記錄層級。記錄層級預設為 Error。
   6. 服務帳戶：選取具備必要角色的服務帳戶。
   7. 視需要設定「連線節點設定」：
      • 節點數量下限：輸入連線節點數量下限。
      • 節點數量上限：輸入連線節點數量上限。

      節點是用來處理交易的連線單位 (或備用資源)。連線處理的交易量越多，就需要越多節點；反之，處理的交易量越少，需要的節點就越少。如要瞭解節點對連線器定價的影響，請參閱「 連線節點定價」。如未輸入任何值，系統預設會將節點下限設為 2 (提高可用性)，節點上限則設為 50。

   注意：只有預付方案客戶可以自訂連線節點值。
   8. 視需要輸入下列屬性：
      • Odata 版本：要使用的 OData 版本。根據預設，連接器會自動嘗試判斷服務使用的版本。
      • 參數實體集：以逗號分隔清單的形式提供參數實體集名稱，用於連線中使用的 Odata 服務所公開的計算檢視畫面
      • 支援擴展選取這個核取方塊，指出是否可從基本實體集擷取導覽屬性
      • 支援公式：選取這個核取方塊，指出 OData 服務是否支援伺服器端公式
      • 使用 Etag：勾選這個核取方塊，表示 OData 來源是否使用 Etag。
   9. 視需要選取連線執行個體的「支援擴充」核取方塊。這個連線屬性主要用於受限的 OData API，可決定是否能從基本實體集擷取導覽屬性
   10. 選用：按一下「+ 新增標籤」，以鍵/值組合的形式為連線新增標籤。
   11. 點按「下一步」。
   12. 輸入 SSL 的下列屬性：
       • 信任存放區：這個屬性會指定信任存放區。您可以選取圓形按鈕，從「公開」、「私人」或「不安全連線」中選取信任儲存區。
       • 自訂信任儲存庫：這個屬性用於選取包含 PEM 格式自訂信任儲存庫的密鑰。
   13. 選用：按一下「+ 新增標籤」，以鍵/值組合的形式為連線新增標籤。
   14. 點按「下一步」。
5. 在「目的地」部分，輸入要連線的 Odata 服務端點詳細資料。
   1. 目的地類型：選取目的地類型。
      • 目的地類型：從下拉式選單中選取「主機位址」
      • 主機 1：輸入 Odata 端點和通訊埠號碼

      如要輸入其他目的地，請按一下「+新增目的地」。

   2. 您也可以視需要輸入 XSUAA URL 的主機詳細資料，以便在 OAuth 2.0 驗證時擷取 OAuth 權杖：從下拉式選單中選取主機位址
   3. 點按「下一步」。
6. 在「Authentication」(驗證) 部分，輸入驗證詳細資料。
   1. 選取「驗證類型」並輸入相關詳細資料。

      SAP HANA XS Advanced 連接器支援下列驗證類型：

      • 使用者名稱和密碼
      • OAuth 2.0 - 授權碼

   如要瞭解如何設定這些驗證類型，請參閱「設定驗證」。

   2. 點按「下一步」。
7. 檢查：檢查連線和驗證詳細資料。
8. 點選「建立」。

設定驗證機制

根據要使用的驗證方式輸入詳細資料。

• 使用者名稱和密碼
  • 使用者名稱：SAP HANA XS Advanced 使用者名稱
  • 密碼：Secret Manager 密鑰，內含與 SAP HANA XS Advanced 使用者名稱相關聯的密碼。

• OAuth 2.0
  • 用戶端 ID：用於要求存取權杖的用戶端 ID
  • 用戶端密鑰：Secret Manager 密鑰，內含您建立的連結應用程式用戶端密鑰。
  • 您也可以輸入範圍：以半形逗號分隔的所需範圍清單。

重新授權授權碼

如果您使用 OAuth 2.0 驗證類型，且已在 XSA Advanced 連線應用程式中進行任何設定變更，則必須重新授權 SAP HANA XS Advanced 連線。如要重新授權連結，請按照下列步驟操作：

1. 在「連線」頁面中，按一下所需連線。

   系統隨即會開啟連線詳細資料頁面。

2. 按一下「編輯」即可編輯連結詳細資料。
3. 在「驗證」部分中，驗證「OAuth 2.0 - 授權碼」詳細資料。

   視需要進行變更。

4. 按一下 [儲存]。系統會將您帶往連線詳細資料頁面。
5. 在「驗證」部分中，按一下「編輯授權」。系統會顯示「Authorize」(授權) 窗格。
6. 按一下「Authorize」。

   如果授權成功，「連線」頁面的連線狀態會設為「有效」。

建立連結後需執行的其他步驟

如果您選取 OAuth 2.0 - Authorization code 進行驗證，建立連線後必須執行下列額外步驟：

1. 在「連線」頁面中，找出新建立的連線。

   請注意，新連接器的「狀態」會顯示「需要授權」。

2. 按一下「需要授權」。

   系統隨即會顯示「Edit authorization」(編輯授權) 窗格。

3. 將「重新導向 URI」值複製到外部應用程式。
4. 驗證授權詳細資料。
5. 按一下「Authorize」。

   授權成功後，「連線」頁面的連線狀態會設為「有效」。

在整合中，使用 SAP Hana XS Advanced 連線

建立連線後，Apigee Integration 和 Application Integration 都會提供該連線。您可以在整合中透過「連接器」工作使用連線。

• 如要瞭解如何在 Apigee Integration 中建立及使用「連線器」工作，請參閱「連線器工作」。
• 如要瞭解如何在 Application Integration 中建立及使用「連線器」工作，請參閱「連線器工作」。

實體、作業和動作

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

注意：您可以在「連線器工作」中查看連線器的實體、作業和動作。

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

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

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

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

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

注意： 所有實體和動作都會有相關聯的結構定義。舉例來說，動作結構定義會包含參數詳細資料，例如參數名稱和對應的資料型別。連線會在執行階段從後端擷取實體和動作的結構定義 (中繼資料)。如果架構有任何更新，現有連線不會自動反映這些更新，您必須手動重新整理架構。如要重新整理連線的結構定義，請開啟連線的「連線詳細資料」頁面，然後按一下「重新整理連線結構定義」。

系統限制

SAP HANA XS Advanced 連接器每秒最多可處理 12 筆交易，每個節點皆是如此，且會節流任何超出此限制的交易。根據預設，Integration Connectors 會為連線分配 2 個節點 (提高可用性)。

如要瞭解 Integration Connectors 適用的限制，請參閱「限制」一文。

注意：整合連接器節點的數量會根據用量自動動態調整。不過，如要為大量資料保留容量，不必等待自動調度資源，可以調整連線的節點數量下限。如要處理連線的更多交易，就需要更多節點。反之，如果連線處理的交易較少，則需要的節點也較少。如要設定節點值，請按照下列步驟操作：

• 如果您是隨用隨付方案客戶，請在編輯連線頁面中設定節點的最小值和最大值。
• 如果您是訂閱型客戶，請與支援團隊聯絡。

節點可處理的最大交易量取決於多項因素。因此，建議您先檢查後端系統是否已完成最佳化設定，可處理所需流量，再調整節點下限以提升輸送量。

實體

SAP HANA XS Advanced 連接器僅支援實體

實體作業範例

範例 - 列出實體的記錄

這個範例會列出 Users 實體的記錄。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Users。
3. 選取「List」作業，然後按一下「完成」。
4. 在「連線器」工作的「工作輸入」部分，您可以根據需求設定 filterClause。

   舉例來說，如果將篩選子句設為 employeeCode='5100' and startDate='2010-01-01 00:00:00'，系統只會列出 employeeCode 為 5100 且 startDate 為 2010-01-01 00:00:00 的記錄。

範例 - 從實體取得單一記錄

這個範例會從 Users 實體擷取記錄。

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

   其中 103032 是 Users 實體的主鍵值。

範例 - 從實體刪除記錄

這個範例會從 Users 實體刪除記錄。

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

   或者，如果實體具有複合式主鍵，而非指定 entityId，則可以設定 filterClause。例如：employeeCode='5100' and startDate='2010-01-01 00:00:00'。

範例 - 在實體中建立記錄

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

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

   {
   "employeeCode": "5100",
   "startDate": "2010-01-01 00:00:00.0",
   "country": "US"
   }

如果整合成功，連接器工作的 connectorOutputPayload 欄位會顯示建立作業的回應。

範例 - 更新實體中的記錄

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

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

   {
   "country": "IN"
   }

5. 在「連線器」工作的「工作輸入」部分，按一下「entityId」，然後在「預設值」欄位中輸入 113132。

   或者，如果實體具有複合式主鍵，而非指定 entityId，則可以設定 filterClause。例如：employeeCode='5100' and startDate='2010-01-01 00:00:00'。

如果整合成功，連接器工作的 connectorOutputPayload 欄位會顯示更新作業的回應。

向 Google Cloud 社群尋求協助

如要發布問題及討論這個連接器，請前往 Cloud 論壇的 Google Cloud 社群。

後續步驟

• 瞭解如何暫停及恢復連線。
• 瞭解如何監控連結器用量。
• 瞭解如何查看連接器記錄。