Share via

針對 Dynamics 365、Dataverse (Common Data Service) 和 Dynamics CRM 連接器在 Azure Data Factory 和 Azure Synapse 中的問題進行疑難排解

  • 發行項

適用於：Azure Data Factory Azure Synapse Analytics

提示

試用 Microsoft Fabric 中的 Data Factory，這是適用於企業的全方位分析解決方案。 Microsoft Fabric 涵蓋從資料移動到資料科學、即時分析、商業智慧和報告的所有項目。 了解如何免費開始新的試用！

本文提供建議，供您針對 Dynamics 365、Dataverse (Common Data Service) 和 Dynamics CRM 連接器在 Azure Data Factory 和 Azure Synapse 中的常見問題進行疑難排解。

錯誤碼：DynamicsCreateServiceClientError

  • 訊息：This is a transient issue on Dynamics server side. Try to rerun the pipeline.

  • 原因：此問題是 Dynamics 伺服器端的暫時性問題。

  • 建議：重新執行管線。 如果再次失敗，請嘗試減少平行處理原則。 如果問題持續存在，請連絡 Dynamics 產品支援部門。

匯入結構描述或預覽資料時遺漏資料行

  • 徵兆：匯入結構描述或預覽資料時遺漏部分資料行。 錯誤訊息：The valid structure information (column name and type) are required for Dynamics source.

  • 原因：此問題在於設計本身，因為 Data Factory 和 Synapse 管線無法顯示前 10 筆記錄中未包含任何值的資料行。 請確定您新增的資料行格式正確。

  • 建議：手動在 [對應] 索引卷標中新增資料行。如需詳細資訊，請參閱明確對應。

錯誤碼：DynamicsMissingTargetForMultiTargetLookupField

  • 訊息：Cannot find the target column for multi-target lookup field: '%fieldName;'.

  • 原因：目標資料行不存在於來源或資料行對應中。

  • 建議：

    1. 請確定來源包含目標資料行。
    2. 在資料行對應中新增目標資料行。 請確定接收器資料行的格式為 {fieldName}@EntityReference。

錯誤碼：DynamicsInvalidTargetForMultiTargetLookupField

  • 訊息：The provided target: '%targetName;' is not a valid target of field: '%fieldName;'. Valid targets are: '%validTargetNames;'

  • 原因：多目標查閱欄位的目標實體名稱不正確。

  • 建議：為多目標查閱欄位提供有效的實體名稱。

錯誤碼：DynamicsInvalidTypeForMultiTargetLookupField

  • 訊息：The provided target type is not a valid string. Field: '%fieldName;'.

  • 原因：目標資料行內的值不是字串。

  • 建議：為多目標查閱目標資料行提供有效的字串。

錯誤碼：DynamicsFailedToRequetServer

  • 訊息：The Dynamics server or the network is experiencing issues. Check network connectivity or check Dynamics server log for more details.

  • 原因：Dynamics 伺服器不穩定或無法存取，或網路發生問題。

  • 建議：如需詳細資訊，請檢查網路連線能力，或檢查 Dynamics 伺服器記錄。 如需進一步的協助，請連絡 Dynamics 支援服務。

錯誤碼：DynamicsFailedToConnect

  • 訊息：Failed to connect to Dynamics: %message;

  • 原因與建議：有不同的原因可能會導致此錯誤。 請查看下列清單，以了解可能原因的分析與相關建議。

    原因分析 建議
    如果您的使用案例符合所有下列三個條件，則會看到 ERROR REQUESTING ORGS FROM THE DISCOVERY SERVERFCB 'EnableRegionalDisco' is disabled. 或 Unable to Login to Dynamics CRM, message:ERROR REQUESTING Token FROM THE Authentication context - USER intervention required but not permitted by prompt behavior AADSTS50079: Due to a configuration change made by your administrator, or because you moved to a new location, you must enroll in multi-factor authentication to access '00000007-0000-0000-c000-000000000000'：
  • 您已連線至 Dynamics 365、Common Data Service 或 Dynamics CRM。
  • 您使用 Office365 驗證。
  • 您的租用戶和使用者已在 Microsoft Entra ID 中設定條件式存取和/或需要多重要素驗證 (請造訪此連結參閱 Dataverse 文件)。
    • 在這些情況下，2021 年 6 月 8 日前仍能成功連線。 自 2021 年 6 月 9 日起，連線會因遭區域探索服務淘汰而失敗 (請參閱此連結)。    		 若租用戶和使用者已在 Microsoft Entra ID 中設定條件式存取和/或需要多重要素驗證，則必須在 2021 年 6 月 8 日後使用「Microsoft Entra 服務主體」進行驗證。 詳細步驟請參閱此連結。
    如果您在錯誤訊息中看到 Office 365 auth with OAuth failed，表示您的伺服器可能有一些與 OAuth 不相容的設定。
  • 請連絡 Dynamics 支援小組，並提供詳細錯誤訊息以取得協助。
  • 使用服務主體驗證。請參閱這篇文章：範例：使用 Microsoft Entra 服務主體和憑證驗證的 Dynamics 連線。
    		•
    如果您在錯誤訊息中看到 Unable to retrieve authentication parameters from the serviceUri，表示您輸入錯誤的 Dynamics 服務 URL 或 Proxy/防火牆來攔截流量。
  • 請確定您在連結服務中放置正確的服務 URI。
  • 如果您使用自我裝載 IR，請確定防火牆/Proxy 不會攔截對 Dynamics 伺服器的要求。
    		•
    如果您在錯誤訊息中看到 An unsecured or incorrectly secured fault was received from the other party，表示從伺服器端收到非預期的回應。
  • 如果您使用 Office 365 驗證，請確定您的使用者名稱和密碼正確無誤。
  • 請確定您已輸入正確的服務 URI。
  • 如果您使用區域 CRM URL (URL 在「crm」之後有數字)，請確定您使用正確的區域識別碼。
  • 連絡 Dynamics 支援小組取得協助。
    		•
    如果您在錯誤訊息中看到 No Organizations Found，表示您的組織名稱有誤，或您在服務 URL 中使用錯誤的 CRM 區域識別碼。
  • 請確定您已輸入正確的服務 URI。
  • 如果您使用區域 CRM URL (URL 在「crm」之後有數字)，請確定您使用正確的區域識別碼。
  • 連絡 Dynamics 支援小組取得協助。
    		•
    如果您看到 401 Unauthorized 和 Microsoft Entra 相關的錯誤訊息，表示服務主體發生問題。 請遵循錯誤訊息的指引修正服務主體的問題。
    其他錯誤通常是伺服器端的問題。 使用 XrmToolBox (英文) 進行連線。 如果錯誤持續發生，請連絡 Dynamics 支援小組取得協助。

錯誤碼：DynamicsOperationFailed

  • 訊息：Dynamics operation failed with error code: %code;, error message: %message;.

  • 原因：伺服器端的作業失敗。

  • 建議：從錯誤訊息擷取 dynamics 作業的錯誤碼：Dynamics operation failed with error code: {code}，並參閱 Web 服務錯誤碼一文取得詳細資訊。 如有需要，請連絡 Dynamics 支援小組。

錯誤碼：DynamicsInvalidFetchXml

  • 訊息：The Fetch Xml query specified is invalid.

  • 原因：擷取 XML 中存在錯誤。

  • 建議：修正擷取 XML 中的錯誤。

錯誤碼：DynamicsMissingKeyColumns

  • 訊息：Input DataSet must contain keycolumn(s) in Upsert/Update scenario. Missing key column(s): %column;

  • 原因：來源資料不包含接收實體的索引鍵資料行。

  • 建議：確認索引鍵資料行位於來源資料中，或將來源資料行對應至接收實體上的索引鍵資料行。

錯誤碼：DynamicsPrimaryKeyMustBeGuid

  • 訊息：The primary key attribute '%attribute;' must be of type guid.

  • 原因：主索引鍵資料行的型別不是 'Guid'。

  • 建議：確定來源資料的主索引鍵資料行屬於 'Guid' 型別。

錯誤碼：DynamicsAlternateKeyNotFound

  • 訊息：Cannot retrieve key information of alternate key '%key;' for entity '%entity;'.

  • 原因：提供的替代金鑰不存在，可能是因為金鑰名稱錯誤或權限不足所導致。

  • 建議：

    • 修正金鑰名稱中的錯字。
    • 確定您對實體擁有足夠的權限。

錯誤碼：DynamicsInvalidSchemaDefinition

  • 訊息：The valid structure information (column name and type) are required for Dynamics source.

  • 原因：資料行對應的接收資料行遺漏 'type' 屬性。

  • 建議：您可以使用入口網站上 JSON 編輯器，將 'type' 屬性新增至資料行對應中的資料行。

錯誤碼：UserErrorUnsupportedAttributeType

  • 訊息：The attribute type 'Lookup' of field %attributeName; is not supported

  • 原因：將資料載入 Dynamics 接收器時，Azure Data Factory 會對查閱屬性的中繼資料實行驗證。 但有一個已知問題，某些 Dynamics 實體並未具備存有目標清單的有效查閱屬性中繼資料，這會導致驗證失敗。

  • 建議：請連絡 Dynamics 支援小組以緩解問題。

Dynamics 365 的複製活動讀取超過實際數目的資料列

  • 徵兆：Dynamics 365 複製活動讀取的資料列超過實際數目。

  • 原因：Dynamics 365 伺服器會一律指出更多可用的記錄。

  • 建議：使用 XrmToolBox 以分頁測試 FetchXML。 已安裝工具的 XrmToolBox 可取得記錄計數。 如需詳細資訊，請參閱 XrmToolBox (英文)。

無法從複製活動中自 Dynamics 來源存取虛擬資料行

  • 徵兆：您無法從複製活動中自 Dynamics 來源存取虛擬資料行。

  • 原因：目前不支援虛擬資料行。

  • 建議：針對 [選項組] 的值，請依下列選項獲取之：

Dynamics CRM 資料存放區中的平行複製

  • 徵兆：您不知道是否可以在 Dynamics CRM 資料存放區中設定平行複製，也不知道可以在「平行複製處理原則程度」區段中設定的值的範圍。

  • 建議：平行複製可控制平行處理原則，而「平行複製處理原則程度」區段可以設定為非零值。 數字太大可能會導致動態伺服器端節流並降低輸送量，但目前處理節流是透過公用 SDK。

    Diagram of Degree of copy parallelism section.

動態型別轉換

  • 徵兆：您嘗試將 GUID 轉換成 Dynamics 來源中的字串，但發生錯誤。

  • 原因：系統不支援將 Dynamics 當作來源的型別轉換。

  • 建議：啟用暫存並重試。

相關內容

如需更多疑難排解的協助，請嘗試下列資源：