在複製活動中設定 Dataverse

本文概述如何使用資料管線中的複製活動，從 Dataverse 複製資料及將資料複製到該處。

必要條件

若要搭配 Microsoft Entra 服務主體驗證使用此連接器，您必須在 Dataverse 中設定伺服器對伺服器 (S2S) 驗證。 請先在 Microsoft Entra 中註冊應用程式使用者 (服務主體)。 如需詳細資訊，請參閱建立可存取資源的 Microsoft Entra 應用程式和服務主體。

在應用程式註冊期間，您必須在 Dataverse 中建立該使用者，並授與權限。 您可以將應用程式使用者新增至 Dataverse 中已授與權限的團隊，以直接或間接的方式授與這些許可權。 如需有關如何設定應用程式使用者向 Dataverse 進行驗證的詳細資訊，請參閱使用單一租用戶伺服器對伺服器驗證。

支援的設定

如需複製活動下每個索引標籤的組態，請分別移至下列各節。

• 一般
• 來源
• 目的地
• 對應
• 設定

一般

如需 [一般] 索引標籤組態，請移至 [一般設定]。

來源

移至 [來源] 索引標籤以設定複製活動來源。 如需詳細的組態，請參閱下列內容。

以下是必要的屬性：

• 資料存放區類型：選取 [外部]。
• 連線：從連線清單中選取現有的 Dataverse 連線。 如果不存在連線，請選取 [新增]，以建立新的 Dataverse 連線。
• 連線類型：選取 [Dataverse]。
• 使用查詢：指定用於讀取資料的方式。 您可以選擇 [實體名稱] 以使用實體名稱讀取資料，或選擇 [查詢] 以使用查詢讀取資料。

  • 實體名稱：從下拉式清單中選取您的實體名稱，或選取 [編輯] 以手動輸入。 它是要擷取之實體的邏輯名稱。

  • 查詢：使用 FetchXML 從 Dataverse 讀取資料。 FetchXML 為在 Dynamics 線上版和內部部署中所使用的專屬查詢語言。 請參閱下列範例。 如需深入了解，請參閱使用 FetchXML 組建查詢。

    範例 FetchXML 查詢：

    <fetch>
      <entity name="account">
        <attribute name="accountid" />
        <attribute name="name" />
        <attribute name="marketingonly" />
        <attribute name="modifiedon" />
        <order attribute="modifiedon" descending="false" />
        <filter type="and">
          <condition attribute ="modifiedon" operator="between">
            <value>2017-03-10 18:40:00z</value>
            <value>2017-03-12 20:40:00z</value>
          </condition>
        </filter>
      </entity>
    </fetch>
    

在 [進階] 下，您可以指定下列欄位：

• 其他資料行：新增其他資料行以儲存來源檔案的相對路徑或靜態值。 後者支援運算式。 如需詳細資訊，請移至在複製期間新增其他資料行。

Destination

移至 [目的地] 索引標籤以設定複製活動目的地。 如需詳細的組態，請參閱下列內容。

以下是必要的屬性：

• 資料存放區類型：選取 [外部]。
• 連線：從連線清單中選取現有的 Dataverse 連線。 如果不存在連線，請選取 [新增]，以建立新的 Dataverse 連線。
• 連線類型：選取 [Dataverse]。
• 實體名稱：指定要寫入資料的實體名稱。 從下拉式清單中選取您的實體名稱，或選取 [編輯] 以手動輸入。 這是要擷取之實體的邏輯名稱。

在 [進階] 下，您可以指定下列欄位：

• 寫入行為：作業的寫入行為。 這是必要屬性，您必須選取 [Upsert]。 如果您使用 [新增動態內容]，請將值指定為 Upsert。
• 其他索引鍵名稱：指定實體上定義的替代索引鍵名稱，以 upsert 記錄。
• 略過 null 值：指出在寫入作業期間是否要略過輸入資料中的 null 值。 預設為選取狀態。
  • 選取時：執行 upsert/更新作業時，讓目的地物件中的資料保持不變，並在執行插入作業時插入定義的預設值。
  • 未選取時：執行 upsert/更新作業時，將目的地物件中的資料更新為 NULL，並在執行插入作業時插入 NULL 值。
• 寫入批次大小：指定每個批次中寫入 Dataverse 的資料列計數。
• 並行連線數上限：在活動執行期間建立至資料存放區的並行連線上限。 僅在想要限制並行連線時，才需要指定值。

對應

如需 [對應] 索引標籤組態，請移至在 [對應] 索引標籤下設定對應。如果您選擇 [二進位] 作為檔案格式，則不支援對應。

設定

如需 [設定] 索引標籤組態，請移至在 [設定] 索引標籤下進行其他設定]。

資料表摘要

如需 Dataverse 複製活動的摘要和詳細資訊，請參閱下表。

來源資訊

名稱	描述:	值	必要	JSON 指令碼屬性
資料存放區類型	您的資料存放區類型。	外部	Yes	/
[連接]	您與來源 Dataverse 的連線。	<您的連線>	Yes	connection
連線類型	您的連線類型。	Dataverse	Yes	類型 (在 typeProperties ->source ->datasetSettings 下)： CommonDataServiceForAppsEntity
使用查詢	從 Dataverse 讀取資料的方式	* 資料表 * 查詢	Yes	/
實體名稱	要擷取之實體的邏輯名稱。	<您的實體名稱>	Yes	entityName
查詢	使用 FetchXML 從 Dataverse 讀取資料。 FetchXML 為在 Dynamics 線上版和內部部署中所使用的專屬查詢語言。 如需深入了解，請參閱使用 FetchXML 組建查詢。	<您的查詢>	Yes	query
其他資料行	新增其他資料行以儲存來源檔案的相對路徑或靜態值。 後者支援運算式。 如需詳細資訊，請移至在複製期間新增其他資料行。	* 名稱 * 值	No	additionalColumns： * 名稱 * 值

目的地資訊

名稱	描述:	值	必要	JSON 指令碼屬性
資料存放區類型	您的資料存放區類型。	外部	Yes	/
[連接]	您與目的地 Dataverse 的連線。	<您的連線>	Yes	connection
連線類型	您的連線類型。	Dataverse	Yes	類型 (在 typeProperties ->sink ->datasetSettings 下)： CommonDataServiceForAppsEntity
實體名稱	要擷取之實體的邏輯名稱。	<您的實體>	Yes	entityName
寫入行為	作業的寫入行為。 該值必須為 [Upsert]。	Upsert	Yes	writeBehavior：upsert
其他索引鍵名稱	在實體上定義的其他索引鍵名稱，以 upsert 記錄。	<其他索引鍵名稱>	No	alternateKeyName
略過 null 值	指出在寫入作業期間是否要略過輸入資料中的 null 值。 - 已選取 (true)：執行 upsert/更新作業時，讓目的地物件中的資料保持不變，並在執行插入作業時插入定義的預設值。 - 未選取 (false)：執行 upsert/更新作業時，將目的地物件中的資料更新為 NULL，並在執行插入作業時插入 NULL 值。	已選取或未選取 (預設值)	No	ignoreNullValues： true 或 false (預設值)
寫入批次大小	每個批次中寫入 Dataverse 的資料列計數。	<您的寫入批次大小> 預設值為 10	No	writeBatchSize
並行連線數上限	在活動執行期間建立至資料存放區的同時連線上限。 僅在想要限制並行連線時，才需要指定值。	<並行連線數上限>	No	maxConcurrentConnections

相關內容

• Dataverse 連接器概觀