通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

排查 Azure 数据工厂 Azure Synapse Analytics 连接器问题

  • 项目

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

提示

试用 Microsoft Fabric 中的数据工厂，这是一种适用于企业的一站式分析解决方案。 Microsoft Fabric 涵盖从数据移动到数据科学、实时分析、商业智能和报告的所有内容。 了解如何免费开始新的试用！

本文介绍如何排查 Azure 数据工厂和 Azure Synapse Analytics 中的连接器问题。

特定于连接器的问题

可以参考每个连接器的故障排除页来查看特定于该连接器的问题、这些问题的原因解释及其解决方法建议。

常规复制活动错误

使用复制活动时经常会出现以下错误，任何连接器都可能发生这些错误。

错误代码：20000

  • 消息：Java Runtime Environment cannot be found on the Self-hosted Integration Runtime machine. It is required for parsing or writing to Parquet/ORC files. Make sure Java Runtime Environment has been installed on the Self-hosted Integration Runtime machine.

  • 原因：自承载 IR 找不到 Java 运行时。 读取特定的源时需要 Java 运行时。

  • 建议：检查集成运行时环境，具体请参阅使用自承载集成运行时。

错误代码：20002

  • 消息：An error occurred when invoking Java Native Interface.

  • 原因：如果错误消息包含“无法创建 JVM: JNI 返回代码 [-6][JNI 调用失败: 参数无效。]”，则可能的原因是设置了一些非法的（全局）参数，导致无法创建 JVM。

  • 建议：登录托管自承载集成运行时的每个节点的计算机。 检查确保系统变量设置正确，如下所示：_JAVA_OPTIONS "-Xms256m -Xmx16g" with memory bigger than 8G。 重启所有集成运行时节点，然后重新运行该管道。

错误代码：20020

  • 消息：Wildcard in path is not supported in sink dataset. Fix the path: '%setting;'.

  • 原因：接收器数据集不支持通配符值。

  • 建议：检查接收器数据集并重写路径（不使用通配符值）。

FIPS 问题

  • 故障描述：复制活动在启用了 FIPS 的自承载 IR 计算机上失败，错误消息如下：This implementation is not part of the Windows Platform FIPS validated cryptographic algorithms.

  • 原因：使用 Azure Blob 和 SFTP 等连接器复制数据时，可能会发生此错误。 美国联邦信息处理标准 (FIPS) 定义了允许使用的一组特定加密算法。 当计算机上启用了 FIPS 模式时，某些情况下会阻止复制活动所依赖的某些加密类。

  • 解决方案：了解为什么我们不再推荐“FIPS 模式”，并评估你是否可在自承载 IR 计算机上禁用 FIPS。

    或者，如果只想绕过 FIPS 并使活动运行成功，请执行以下步骤：

    1. 打开安装自承载 IR 的文件夹。 路径通常是 C:\Program Files\Microsoft Integration Runtime <IR version>\Shared。

    2. 打开 diawp.exe.config 文件，然后在 <runtime> 部分的末尾添加 <enforceFIPSPolicy enabled="false"/>，如下所示：

      显示已禁用 FIPS 的 diawp.exe.config 文件部分的屏幕截图。

    3. 保存文件，然后重启自承载 IR 计算机。

错误代码：20150

  • 消息：Failed to get access token from your token endpoint. Error returned from your authorization server: %errorResponse;.

  • 原因：客户端 ID 或客户端机密无效，并且身份验证在授权服务器中失败。

  • 建议：更正授权服务器的所有 OAuth2 客户端凭据流设置。

错误代码：20151

  • 消息：Failed to get access token from your token endpoint. Error message: %errorMessage;.

  • 原因：OAuth2 客户端凭据流设置无效。

  • 建议：更正授权服务器的所有 OAuth2 客户端凭据流设置。

错误代码：20152

  • 消息：The token type '%tokenType;' from your authorization server is not supported, supported types: '%tokenTypes;'.

  • 原因：不支持授权服务器。

  • 建议：使用可以返回具有受支持令牌类型的令牌的授权服务器。

错误代码：20153

  • 消息：The character colon(:) is not allowed in clientId for OAuth2ClientCredential authentication.

  • 原因：客户端 ID 包含无效的字符冒号 (:)。

  • 建议：使用有效的客户端 ID。

错误代码：20523

  • 消息：Managed identity credential is not supported in this version ('%version;') of Self Hosted Integration Runtime.

  • 建议：检查支持的版本，并将集成运行时升级到更高版本。

错误代码：20551

  • 消息：The format settings are missing in dataset %dataSetName;.

  • 原因：数据集类型为不受支持的二进制类型。

  • 建议：请改为使用 DelimitedText、Json、Avro、Orc 或 Parquet 数据集。

  • 原因：对于文件存储，数据集中缺少格式设置。

  • 建议：取消选择数据集中的“二进制副本”并设置正确的格式设置。

错误代码：20552

  • 消息：The command behavior "%behavior;" is not supported.

  • 建议：不要将命令行为添加为可供预览的参数或 GetSchema API 请求 URL 的参数。

错误代码：20701

  • 消息：Failed to retrieve source file ('%name;') metadata to validate data consistency.

  • 原因：接收器数据存储存在暂时性问题，或者不允许从接收器数据存储检索元数据。

错误代码：20703

  • 消息：Failed to retrieve sink file ('%name;') metadata to validate data consistency.

  • 原因：接收器数据存储存在暂时性问题，或者不允许从接收器数据存储检索元数据。

错误代码：20704

  • 消息：Data consistency validation is not supported in current copy activity settings.

  • 原因：仅直接二进制复制场景中支持数据一致性验证。

  • 建议：删除复制活动有效负载中的“validateDataConsistency”属性。

错误代码：20705

  • 消息：'validateDataConsistency' is not supported in this version ('%version;') of Self Hosted Integration Runtime.

  • 建议：检查支持的集成运行时版本，将其升级到更高版本，或者从复制活动中删除“validateDataConsistency”属性。

错误代码：20741

  • 消息：Skip missing file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.

  • 建议：删除复制活动有效负载中 skipErrorFile 设置的“fileMissing”。

错误代码：20742

  • 消息：Skip inconsistency is not supported in current copy activity settings, it's only supported with direct binary copy when validateDataConsistency is true.

  • 建议：删除复制活动有效负载中 skipErrorFile 设置的“dataInconsistency”。

错误代码：20743

  • 消息：Skip forbidden file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.

  • 建议：删除复制活动有效负载中 skipErrorFile 设置的“fileForbidden”。

错误代码：20744

  • 消息：Skip forbidden file is not supported for this connector: ('%connectorName;').

  • 建议：删除复制活动有效负载中 skipErrorFile 设置的“fileForbidden”。

错误代码：20745

  • 消息：Skip invalid file name is not supported in current copy activity settings, it's only supported with direct binary copy with folder.

  • 建议：删除复制活动有效负载中 skipErrorFile 设置的“invalidFileName”。

错误代码：20746

  • 消息：Skip invalid file name is not supported for '%connectorName;' source.

  • 建议：删除复制活动有效负载中 skipErrorFile 设置的“invalidFileName”。

错误代码：20747

  • 消息：Skip invalid file name is not supported for '%connectorName;' sink.

  • 建议：删除复制活动有效负载中 skipErrorFile 设置的“invalidFileName”。

错误代码：20748

  • 消息：Skip all error file is not supported in current copy activity settings, it's only supported with binary copy with folder.

  • 建议：删除复制活动有效负载中 skipErrorFile 设置的“allErrorFile”。

错误代码：20771

  • 消息：'deleteFilesAfterCompletion' is not support in current copy activity settings, it's only supported with direct binary copy.

  • 建议：删除“deleteFilesAfterCompletion”设置或使用直接二进制副本。

错误代码：20772

  • 消息：'deleteFilesAfterCompletion' is not supported for this connector: ('%connectorName;').

  • 建议：删除复制活动有效负载中的“deleteFilesAfterCompletion”设置。

错误代码：27002

  • 消息：Failed to download custom plugins.

  • 原因：下载链接无效或暂时性连接问题。

  • 建议：如果消息显示它是暂时性问题，请重试。 如果问题持续出现，请联系技术支持。

一般连接器错误

错误代码：9611

  • 消息：The following ODBC Query is not valid: '%'.

  • 原因：你提供了错误或无效的查询来提取数据/架构。

  • 建议：验证查询是否有效，并可以返回数据/架构。 如果要执行非查询脚本并且支持数据存储，请使用脚本活动。 或者，请考虑使用返回虚拟结果的存储过程来执行非查询脚本。

错误代码：11775

  • 消息：Failed to connect to your instance of Azure Database for PostgreSQL flexible server. '%'

  • 原因：具体原因取决于 '%' 中返回的文本。 如果是“操作已超时”，则可能是因为 PostgreSQL 实例已停止，或者是因为为实例配置的网络连接方法不允许从所选的 Integration Runtime 进行连接。 提供的用户或密码不正确。 如果是“28P01: 用户 <youruser> 的密码验证失败”，则表示提供的用户在实例中不存在或密码不正确。 如果是“28000: 没有主机 "###.###.###.###"、用户“<youruser>”、数据库“<yourdatabase>”的 pg_hba.conf 条目，没有加密”，则表示所选的加密方法与服务器的配置不兼容。

  • 建议：确认提供的用户存在于 PostgreSQL 实例中，并且密码与当前分配给该用户的密码相同。 确保 PostgreSQL 实例根据当前配置接受所选的加密方法。 如果实例的网络连接方法配置为专用访问（虚拟网络集成），请使用自承载集成运行时 (IR) 与它连接。 如果配置为公共访问（允许的 IP 地址），建议将 Azure IR 与托管虚拟网络配合使用，并部署托管专用终结点以连接到实例。 当配置为公共访问（允许的 IP 地址）时，不太推荐的替代方法包括在实例中创建防火墙规则，以允许来自正在使用的 Azure IR 所用 IP 地址的流量。

相关内容

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