設定 Microsoft Dataverse 來源的 CDC

Datastream 可讓您將 Microsoft Dataverse 環境中的變更資料,串流至支援的目的地,例如 BigQuery 或 Cloud Storage。如要準備來源,請在 Microsoft Entra ID 中註冊 OAuth 2.0 用戶端、設定 Dataverse 應用程式使用者,並視需要允許 Datastream 公開 IP 位址。

事前準備

開始設定 Dataverse 以搭配使用 Datastream 前,請先完成下列事項:

  • 具備有效的 Microsoft Azure 訂閱項目存取權,以及管理 Azure Active Directory (AAD) 和 Dataverse 的權限。
  • 具備有效的 Dataverse 環境。
  • 瞭解如何在 Microsoft Azure 入口網站、Dataverse 和 Dynamics 365 中瀏覽及變更設定。
  • 具備在 AAD 中註冊應用程式的權限,以及在 Dataverse 中建立或指派角色的權限。

設定 Microsoft Dataverse 環境,以便搭配 Datastream 使用

如要在 Dataverse 環境與 Datastream 之間建立連線,請使用 OAuth 2.0 用戶端憑證流程進行驗證。這項操作需要在 AAD 中註冊應用程式,並在 Dataverse 中設定應用程式使用者。

在 Azure Active Directory 中註冊應用程式

Dataverse 使用 AAD 進行驗證。如要註冊應用程式,請按照下列步驟操作:

  1. 使用管理員帳戶登入 Azure 入口網站。
  2. 在入口網站中,依序前往「Azure Active Directory」>「App registrations」>「New registration」。
  3. 註冊應用程式:

    1. 在「應用程式名稱」下方,輸入應用程式名稱,例如 DatastreamDataverseConnector。
    2. 選取帳戶類型,通常是「Accounts in this organizational directory only」。
    3. 按一下「註冊」。
  4. 註冊後,請將「Overview」頁面中的「Application (client) ID」和「Directory (tenant) ID」複製到安全的位置,以供日後使用。Datastream 連線設定檔需要這些 ID。

  5. 產生用戶端密鑰:

    1. 在已註冊的應用程式設定中,依序前往「憑證與密鑰」>「新增用戶端密鑰」。
    2. 提供密鑰說明並設定到期日。
    3. 按一下「新增」。
  6. 複製產生的密鑰值,因為這個值只會顯示一次。建立 Datastream 連線設定檔時,您需要密鑰。

  7. 指派 API 權限:

    1. 依序前往「API permissions」>「Add a permission」。
    2. 依序選取「Microsoft API」>「Dynamics CRM」。
    3. 選取「應用程式權限」。
    4. 按一下「Grant admin consent for your directory」。

設定 Dataverse 應用程式使用者

在 Dataverse 中建立應用程式使用者,代表 AAD 應用程式。

  1. 以管理員權限登入 Microsoft Dataverse 環境。
  2. 依序前往「設定」>「安全性」>「使用者」。
  3. 將檢視畫面從「已啟用的使用者」變更為「應用程式使用者」。
  4. 按一下「新增」,建立新的應用程式使用者。
  5. 將從 AAD 複製的應用程式 (用戶端) ID 貼到「應用程式 ID」欄位。系統會自動填入其他詳細資料,例如「使用者名稱」。
  6. 儲存記錄。
  7. 指派安全性角色:

    1. 開啟新建立的應用程式使用者記錄。
    2. 按一下 [管理角色]。
    3. 指派適當的安全性角色,為 Datastream 要複製的資料表授予必要的讀取權限。建議您使用自訂角色,並授予特定資料表所需的最低讀取權限,而非使用廣泛的角色,例如「系統管理員」。確認角色有權讀取資料表的中繼資料。

IP 限制

如果您的 Dataverse 環境或網路設有 IP 位址限制,請確保Datastream 公開 IP 位址可連線至 Dataverse 環境網址 (例如 ORGANIZATION_NAME.crm.dynamics.com)。

後續步驟