排查 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 源访问虚拟列。

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

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

  • 可通过参考如何查找任何实体的对象类型代码来获取对象类型代码。
  • 可将 StringMap 实体链接到目标实体并获取关联的值。

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

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

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

  

Dynamics 类型转换

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

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

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

相关内容

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

• 连接器故障排除指南
• 数据工厂 Stack Overflow 论坛