共用方式為


在複製活動中設定 Dataverse

本文概述如何使用數據管線中的複製活動,將數據從 Dataverse 複製和複製到 Dataverse。

必要條件

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

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

支援的組態

如需複製活動下每個索引標籤的設定,請分別移至下列各節。

一般

針對 [一般] 索引標籤組態,移至 [般設定]。

來源

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

Screenshot showing source tab and the list of properties.

需要下列屬性

  • 數據存放區類型:選取 [外部]。
  • 連線:從聯機清單中選取現有的 Dataverse 連線。 如果沒有連線存在,請選取 [新增],以建立新的Dataverse連線。
  • 連線 ion 類型:選取 [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

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

Screenshot showing destination tab and the list of properties.

需要下列屬性

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

在 [進階] 底下,您可以指定下列欄位:

  • 寫入行為:作業的寫入行為。 這是必要屬性,您必須選取 [Upsert]。 如果您使用 [新增動態內容],請將值指定為 Upsert。
  • 替代索引鍵名稱:指定實體上定義的替代索引鍵名稱,以更新插入記錄。
  • 忽略 Null 值:指出是否要在寫入作業期間忽略輸入數據中的 Null 值。 默認會選取它。
    • 選取時:執行 upsert/update 作業時,讓目的地對象中的數據保持不變,並在執行插入作業時插入定義的預設值。
    • 未選取時:執行 upsert/update 作業時,將目的地物件中的數據更新為 NULL,並在執行插入作業時插入 NULL 值。
  • 寫入批次大小:指定每個批次中寫入 Dataverse 的數據列計數。
  • 並行連線上限:活動執行期間,與數據存放區建立的並行連線上限。 只有在您想要限制並行連線時,才指定值。

對應

針對 [對應] 索引標籤標組態,移至 [對應] 索引卷標底下的 [設定對應]。如果您選擇 [二進位] 作為檔案格式,則不支持對應。

設定

如需 [設定] 索引標籤組態,請移至 [設定] 索引卷標底下的 [設定其他設定]。

數據表摘要

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

來源資訊

名稱 描述: 必要 JSON 腳本屬性
數據存放區類型 您的資料存放區類型。 外部 Yes /
[連接] 您與源 Dataverse 的連線。 < 您的連線 > Yes connection
連線類型 您的連線類型。 Dataverse Yes type (下 typeProperties ->source ->datasetSettings):
CommonDataServiceForAppsEntity
使用查詢 從 Dataverse 讀取資料的方式 *表
*查詢
Yes /
實體名稱 要擷取之實體的邏輯名稱。 < 您的實體名稱 > Yes entityName
查詢 使用 FetchXML 從 Dataverse 讀取數據。 FetchXML 是一種專屬的查詢語言,用於 Dynamics 在線和內部部署。 若要深入瞭解,請參閱 使用 FetchXML 建置查詢。 < 您的查詢 > Yes query
其他數據行 新增其他數據行以儲存來源檔案的相對路徑或靜態值。 後者支持表達式。 如需詳細資訊,請移至複製期間新增其他數據行。 *名字
*價值
No additionalColumns:
*名字
*價值

目的地資訊

名稱 描述: 必要 JSON 腳本屬性
數據存放區類型 您的資料存放區類型。 外部 Yes /
[連接] 您與目的地 Dataverse 的連線。 < 您的連線 > Yes connection
連線類型 您的連線類型。 Dataverse Yes type (下 typeProperties ->sink ->datasetSettings):
CommonDataServiceForAppsEntity
實體名稱 要擷取之實體的邏輯名稱。 < 您的實體 > Yes entityName
寫入行為 作業的寫入行為。 此值必須是 Upsert Upsert Yes writeBehavior: upsert
替代索引鍵名稱 實體上定義的替代索引鍵名稱,以更新插入記錄。 < 替代索引鍵名稱 > No alternateKeyName
忽略 Null 值 指出是否要在寫入作業期間忽略輸入數據中的 Null 值。
- 已選取 (true):執行 upsert/update 作業時,讓目的地對象中的數據保持不變,並在執行插入作業時插入定義的預設值。
- 未選取 (false):執行 upsert/update 作業時,將目的地對象中的數據更新為 NULL,並在執行插入作業時插入 NULL 值。
已選取或未選取 (預設值) No ignoreNullValues:
true 或 false (預設值)
寫入批次大小 每個批次中寫入 Dataverse 的數據列計數。 < 您的寫入批次大小 >
預設值為 10
No writeBatchSize
並行連線上限 在活動執行期間,與數據存放區建立的並行連線上限。 只有在您想要限制並行連線時,才指定值。 < 最大並行連線 > No maxConcurrent 連線 ions