針對 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 狀態碼或訊息，並修正遠端伺服器問題。

訊息：The HttpStatusCode %statusCode; indicates failure.
Request URL: %requestUri;
Response payload:%payload;
原因：當 Azure Data Factory 透過 HTTP 通訊協定與 REST 端點通訊，且要求作業失敗時，就會發生此錯誤。
建議：檢查錯誤訊息中的 HTTP 狀態碼、要求 URL 或回應承載，並修正遠端伺服器問題。

訊息：User Configured CompressionType is Not Supported By Azure Data Factory：%message;
建議：檢查 REST 接收器支援的壓縮類型。

徵兆：端點有時會從 REST 連接器收到非預期的回應 (400、401、403、500)。
原因：REST 來源連接器會在建構 HTTP 要求時，使用連結服務/資料集/複製來源中的 URL 和 HTTP 方法/標頭/本文做為參數。此問題很可能是由一或多個指定參數中的某些錯誤所造成。
解決方法：
- 在命令提示字元視窗中使用 'curl'，以查看參數是否為原因 (應一律包含 Accept 和 User-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 憑證，以便用戶端與伺服器建立信任。
  
  針對上述案例，建議使用 Fiddler 之類的工具。

訊息："Failed to create certificate from certificate raw data and password. Cannot find the requested object."
原因：僅支援 REST 連接器服務主體憑證驗證的 Base64 字串服務主體憑證。
建議：請遵循此章節，正確將服務主體憑證儲存在 Azure Key Vault 中。

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