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

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

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

特定于连接器的问题

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

• Azure Blob 存储
• Azure Cosmos DB（包括 Azure Cosmos DB for NoSQL 连接器）
• Azure Data Lake (Gen2)
• Azure Database for PostgreSQL
• Azure 文件存储
• Azure Synapse Analytics、Azure SQL 数据库和 SQL Server
• DB2
• 带分隔符的文本格式
• Dynamics 365、Dataverse (Common Data Service) 和 Dynamics CRM
• FTP、SFTP 和 HTTP
• Hive
• Oracle
• ORC 格式
• Parquet 格式
• REST
• Salesforce 和 Salesforce Service Cloud
• SharePoint Online 列表
• XML 格式

常规复制活动错误

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

错误代码：JreNotFound

• 消息：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 运行时。

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

错误代码：WildcardPathSinkNotSupported

• 消息：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"/>，如下所示：

     

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

错误代码：JniException

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

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

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

错误代码：GetOAuth2AccessTokenErrorResponse

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

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

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

错误代码：FailedToGetOAuth2AccessToken

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

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

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

错误代码：OAuth2AccessTokenTypeNotSupported

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

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

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

错误代码：OAuth2ClientIdColonNotAllowed

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

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

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

错误代码：ManagedIdentityCredentialObjectNotSupported

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

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

错误代码：QueryMissingFormatSettingsInDataset

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

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

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

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

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

错误代码：QueryUnsupportedCommandBehavior

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

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

错误代码：DataConsistencyFailedToGetSourceFileMetadata

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

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

错误代码：DataConsistencyFailedToGetSinkFileMetadata

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

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

错误代码：DataConsistencyValidationNotSupportedForNonDirectBinaryCopy

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

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

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

错误代码：DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime

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

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

错误代码：SkipMissingFileNotSupportedForNonDirectBinaryCopy

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

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

错误代码：SkipInconsistencyDataNotSupportedForNonDirectBinaryCopy

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

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

错误代码：SkipForbiddenFileNotSupportedForNonDirectBinaryCopy

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

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

错误代码：SkipForbiddenFileNotSupportedForThisConnector

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

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

错误代码：SkipInvalidFileNameNotSupportedForNonDirectBinaryCopy

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

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

错误代码：SkipInvalidFileNameNotSupportedForSource

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

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

错误代码：SkipInvalidFileNameNotSupportedForSink

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

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

错误代码：SkipAllErrorFileNotSupportedForNonBinaryCopy

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

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

错误代码：DeleteFilesAfterCompletionNotSupportedForNonDirectBinaryCopy

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

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

错误代码：DeleteFilesAfterCompletionNotSupportedForThisConnector

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

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

错误代码：FailedToDownloadCustomPlugins

• 消息：Failed to download custom plugins.

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

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

一般连接器错误

错误代码：UserErrorOdbcInvalidQueryString

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

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

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

错误代码：FailToResolveParametersInExploratoryController

• 消息：The parameters and expression cannot be resolved for schema operations. The template function 'linkedService' is not defined or not valid.

• 原因：该服务在支持链接服务方面有限制，该链接服务使用用于测试连接或预览数据的参数引用另一个链接服务。 例如，将参数从密钥保管库传递到链接服务可能会出现此问题。

• 建议：删除引用的链接服务中的参数以消除错误。 否则，运行管道而不测试连接或预览数据。

相关内容

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

• 数据工厂 Stack Overflow 论坛