Dataverse

您可以使用 Dataverse 連接器，對自訂資料表執行插入、刪除、更新和讀取作業。

事前準備

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

  • 在 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)

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

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

設定連接器

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

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

    前往「連線」頁面

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

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

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

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

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

      • 節點數量下限：輸入連線節點數量下限。
      • 節點數量上限：輸入連線節點數量上限。

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

    8. Azure 用戶群：用於存取資料的 Microsoft Online 用戶群。如未指定，系統會使用預設租戶。
    9. 機構網址：Microsoft Dataverse 資料的網址。例如：https://abc123.crm.dynamics.com/。
    10. 租戶：用於存取資料的 Microsoft 租戶。如未指定，系統會使用預設租戶。
    11. 您也可以在「API version」(API 版本) 欄位中，指定要使用的 API 版本。如果發布了新版 API，您可以在這個欄位中指定該版本。
    12. 如要允許供應商使用作業的顯示名稱，請選取「使用顯示名稱」。
    13. 結構定義：選取要使用的結構定義。
    14. (選用) 按一下「+ 新增標籤」，以鍵/值組合的形式為連線新增標籤。
    15. 在「SSL Configuration」(SSL 設定) 區段中，選取信任模型：
      • 公開：從預設信任存放區選取的公開憑證。
      • 私人：自行簽署的憑證或私人憑證授權單位核發的憑證
      • 不安全連線：信任所有憑證。建議使用公開或私人的信任模型。
  5. 在「Authentication」(驗證) 部分中，輸入驗證詳細資料。 如要瞭解如何設定這些驗證類型，請參閱「設定驗證」。

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

設定驗證機制

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

  • 用戶端 ID：用於要求存取權杖的用戶端 ID。
  • 範圍：以半形逗號分隔的所需範圍清單。
  • 用戶端密鑰：用於要求存取權杖的用戶端密鑰。
  • 授權網址：建立用戶端時產生的授權網址。

系統限制

Dataverse 連接器每秒可處理 25 筆交易，每個節點每秒可處理 25 筆交易，並節流任何超出此限制的交易。根據預設，Integration Connectors 會為連線分配 2 個節點 (以提高可用性)。

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

實體、作業和動作

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

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

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

  • 作業： 作業是指您可以在實體上執行的活動。您可以對實體執行下列任一操作：

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

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

動作

Dataverse 連接器提供 ListAssociations 和 ListNavigationProperties 等動作。如要瞭解如何設定動作，請參閱「動作範例」。

動作範例

本節說明如何在這個連接器中執行部分動作。

範例 - ListAssociations

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

實體作業範例

範例 - 列出所有自訂表格記錄

這個範例會列出 User defined 資料表中的所有記錄。

  1. 在「Configure connector task」對話方塊中，按一下 Entities。
  2. 從 Entity 清單中選取「自訂表格名稱」。
  3. 選取「LIST」作業，然後按一下「完成」。

範例 - 根據 ID 取得使用者

這個範例會從 Users 實體取得 newTableId 為 568ea947-e03d-ef11-8409-7c1e5217e912 的使用者。

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

    其中 newTableId 是 Custom Table 實體的主鍵值。

  5. 按一下 [完成]。

使用 Terraform 建立連線

您可以使用 Terraform 資源建立新連線。

如要瞭解如何套用或移除 Terraform 設定，請參閱「基本 Terraform 指令」。

如要查看用於建立連線的 Terraform 範本範例，請參閱範本範例。

使用 Terraform 建立這項連線時，您必須在 Terraform 設定檔中設定下列變數：

參數名稱 資料類型 必填 說明
資料庫 STRING 否 SAP HANA 資料庫的名稱。
browsable_schemas STRING 否 這項屬性會將回報的結構定義限制為可用結構定義的子集。例如 BrowsableSchemas=SchemaA,SchemaB,SchemaC。
include_system_objects BOOLEAN 否 將 IncludeSystemObjects 設為 True，即可擷取 Hana 系統結構定義和資料表。
include_table_types BOOLEAN 否 如果設為 True，供應商會回報個別表格和檢視區塊的類型。
session_variables STRING 否 以半形逗號分隔的清單，列出要在目前連線中設定的工作階段變數。
enable_logging ENUM 否 選取 1 (最不詳細) 到 5 (最詳細) 之間的層級，即可在連線期間啟用記錄詳細程度。這項功能有助於排解錯誤訊息或其他非預期行為。不過請注意，這個選項會記錄連接器和後端之間的所有通訊詳細資料，包括要求、回應和 SSL 憑證。因此，不建議在實際工作環境中使用這項功能。支援的值為：1、2、3、4、5

在整合服務中使用 Dataverse 連線

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

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

向 Google Cloud 社群尋求協助

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

後續步驟