Share via


針對 Azure Data Factory 和 Azure Synapse 中的 REST 連接器進行疑難排解

適用於:Azure Data Factory Azure Synapse Analytics

提示

試用 Microsoft Fabric 中的 Data Factory,這是適用於企業的全方位分析解決方案。 Microsoft Fabric 涵蓋從資料移動到資料科學、即時分析、商業智慧和報告的所有項目。 了解如何免費開始新的試用

本文提供針對 Azure Data Factory 和 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 Data Factory 透過 HTTP 通訊協定與 REST 端點通訊,且要求作業失敗時,就會發生此錯誤。

  • 建議:檢查錯誤訊息中的 HTTP 狀態碼、要求 URL 或回應承載,並修正遠端伺服器問題。

錯誤碼:RestSinkUNSupportedCompressionType

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

  • 建議:檢查 REST 接收器支援的壓縮類型。

來自 REST 連接器的非預期網路回應

  • 徵兆 :端點有時會從 REST 連接器收到非預期的回應 (400、401、403、500)。

  • 原因:REST 來源連接器會在建構 HTTP 要求時,使用連結服務/資料集/複製來源中的 URL 和 HTTP 方法/標頭/本文做為參數。 此問題很可能是由一或多個指定參數中的某些錯誤所造成。

  • 解決方法:

    • 在命令提示字元視窗中使用 'curl',以查看參數是否為原因 (應一律包含 AcceptUser-Agent 標題):

      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 憑證,以便用戶端與伺服器建立信任。

      針對上述案例,建議使用 PostmanFiddler 之類的工具。

如需更多疑難排解的協助,請嘗試下列資源: