Compartir a través de

排查 Azure 数据工厂和 Azure Synapse 中 Dynamics 365、Dataverse (Common Data Service) 和 Dynamics CRM 连接器的问题

适用于:Azure 数据工厂 Azure Synapse Analytics

本文提供有关排查 Azure 数据工厂和 Azure Synapse 中 Dynamics 365、Dataverse (Common Data Service) 和 Dynamics CRM 连接器问题的建议。

错误代码:DynamicsCreateServiceClientError

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

  • 原因:此问题是 Dynamics 服务器端的暂时性问题。

  • 建议:重新运行管道。 如果再次失败,请尝试降低并行度。 如果问题仍然存在,请联系 Azure 支持部门。

导入架构或预览数据时缺少列

  • 故障描述:导入架构或预览数据时,缺少某些列。 错误消息:The valid structure information (column name and type) are required for Dynamics source.

  • 原因:此问题是设计使然的,因为数据工厂和 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 身份验证。
  • 租户和用户在 Azure Active Directory 中配置为进行条件访问并且/或者多重身份验证是必需验证方法(点击此链接以参阅 Dataverse 文档)。
  • 在这种情况下,连接曾在 2021/6/8 之前成功。 由于区域发现服务弃用,从 2021/6/9 开始,连接将会失败(请参阅此链接)。
    如果租户和用户在 Azure Active Directory 中配置为进行条件访问并且/或者多重身份验证是必需验证方法,则在 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 或代理/防火墙来拦截流量。
  • 请确保已将正确的服务 URI 置于链接服务中。
  • 如果使用自承载 IR,请确保防火墙/代理不会拦截对 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 operation failed with error code: {code} 中提取 Dynamics 操作的错误代码,并参阅 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 数据工厂对查找属性的元数据进行验证。 但是,已知问题是,某些 Dynamics 实体没有包含目标列表的有效查找属性元数据,这会导致验证失败。

  • 建议:请联系 Dynamics 支持团队来解决该问题。

Dynamics 365 中的复制活动读取的行数多于实际数量

  • 症状:Dynamics 365 中的复制活动读取的行数多于实际数量。

  • 原因:Dynamics 365 服务器始终指示更多可用记录。

  • 建议:使用 XrmToolBox 通过分页测试 FetchXML。 具有一些已安装工具的 XrmToolBox 可以获取记录计数。 有关详细信息,请参阅 XrmToolBox

无法从复制活动中的 Dynamics 源访问虚拟列

  • 症状:无法从复制活动中的 Dynamics 源访问虚拟列。

  • 原因:现在不支持虚拟列。

  • 建议:对于“选项集”值,请按照以下选项获取:

Dynamics CRM 数据存储中的并行复制

  • 症状:不知道能否在 Dynamics CRM 数据存储中配置并行复制,也不知道可在“复制并行度”部分中设置的值的范围。

  • 建议:并行复制控制并行度,“复制并行度”部分可设置为非零值。 较大的数量可能导致 Dynamics 服务器端出现限制,这会降低吞吐量,但现在通过采用公共 SDK 来处理限制。

    复制并行度部分关系图。

Dynamics 类型转换

  • 症状:尝试将 GUID 转换为 Dynamics 源中的字符串,但遇到错误。

  • 原因:将 Dynamics 用作源时,不支持类型转换。

  • 建议:启用暂存并重试。

尝试通过以下资源获得故障排除方面的更多帮助: