排查 Azure 数据工厂 和 Azure Synapse 中的 REST 连接器问题
适用于:Azure 数据工厂 Azure Synapse Analytics
本文提供了一些建议,用于排查 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 证书以供客户端与服务器建立信任。
对于上述情况,建议使用 Fiddler 之类的工具。
Azure Key Vault 中的服务主体证书不正确
- 消息:
"Failed to create certificate from certificate raw data and password. Cannot find the requested object."
- 原因:仅支持用于 Rest 连接器服务主体证书身份验证的 base64 字符串服务主体证书。
- 建议:请按照此部分进行操作,将服务主体证书正确保存到 Azure Key Vault 中。
相关内容
尝试通过以下资源获得故障排除方面的更多帮助: