排查 Azure 数据工厂 和 Azure Synapse 中的 REST 连接器问题

  • 项目

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

提示

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

本文提供了一些建议，用于排查 Azure 数据工厂 和 Azure Synapse 中常见的 REST 连接器问题。

错误代码：RestSinkCallFailed

  • 消息：Rest Endpoint responded with Failure from server. Check the error from server:%message;

  • 原因：如果数据工厂或 Synapse 管道通过 HTTP 协议与 REST 终结点通信，并且请求操作失败，则会发生此错误。

  • 建议：检查错误消息中的 HTTP 状态代码或消息，并修复远程服务器问题。

错误代码：RestSourceCallFailed

  • 消息：The HttpStatusCode %statusCode; indicates failure.
Request URL: %requestUri;
Response payload:%payload;

  • 原因：当 Azure 数据工厂通过 HTTP 协议与 REST 终结点通信，并且请求操作失败时，发生此错误。

  • 建议：检查错误消息中的 HTTP 状态代码、请求 URL 或响应工作负载，并修复远程服务器问题。

错误代码：RestSinkUNSupportedCompressionType

  • 消息：User Configured CompressionType is Not Supported By Azure Data Factory:%message;

  • 建议：检查 REST 接收器支持的压缩类型。

来自 REST 连接器的意外网络响应

  • 故障描述：终结点有时从 REST 连接器收到意外响应（400、401、403、500）。

  • 原因：构造 HTTP 请求时，REST 源连接器使用链接服务/数据集/复制源的 URL 和 HTTP 方法/标头/正文作为参数。 此问题很可能是由一个或多个指定参数中的某些错误引起的。

  • 解决方法：

    • 在命令提示窗口中使用“curl”查看该问题是否是参数导致的（应始终包含“接受”和“用户代理”标头） ）：

      curl -i -X <HTTP method> -H <HTTP header1> -H <HTTP header2> -H "Accept: application/json" -H "User-Agent: azure-data-factory/2.0" -d '<HTTP body>' <URL>

      如果命令返回相同的意外响应，请使用“curl”修复前面的参数，直到它返回预期的响应。

      也可使用“curl--help”来更高级地使用命令。

    • 如果只有 REST 连接器返回意外响应，请联系 Microsoft 支持人员进行进一步的故障排除。

    • 请注意，“curl”可能不适合重现 SSL 证书验证问题。 在某些情况下，“curl”命令成功执行，没有遇到任何 SSL 证书验证问题。 但是，当在浏览器中执行相同的 URL 时，实际上不会返回任何 SSL 证书以供客户端与服务器建立信任。

      对于上述情况，建议使用 Postman 和 Fiddler 之类的工具 。

相关内容

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