針對 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;'.原因：目標資料行不存在於來源或資料行對應中。
建議：
- 請確定來源包含目標資料行。
- 在資料行對應中新增目標資料行。 請確定接收器資料行的格式為 {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 來源存取虛擬資料行。
原因：目前不支援虛擬資料行。
建議：針對 [選項組] 的值，請依下列選項獲取之：
- 您可以參閱如何尋找任何實體的物件類型程式碼，取得物件類型程式碼。
- 您可以將 StringMap 實體連結至目標實體，取得相關聯的值。
Dynamics CRM 資料存放區中的平行複製
徵兆：您不知道是否可以在 Dynamics CRM 資料存放區中設定平行複製，也不知道可以在「平行複製處理原則程度」區段中設定的值的範圍。
建議：平行複製可控制平行處理原則，而「平行複製處理原則程度」區段可以設定為非零值。 數字太大可能會導致動態伺服器端節流並降低輸送量，但目前處理節流是透過公用 SDK。
動態型別轉換
徵兆：您嘗試將 GUID 轉換成 Dynamics 來源中的字串，但發生錯誤。
原因：系統不支援將 Dynamics 當作來源的型別轉換。
建議：啟用暫存並重試。
相關內容
如需更多疑難排解的協助，請嘗試下列資源：