Share via


Solucionar problemas do conector de REST no Azure Data Factory e no Azure Synapse

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Dica

Experimente o Data Factory no Microsoft Fabric, uma solução de análise tudo-em-um para empresas. O Microsoft Fabric abrange desde movimentação de dados até ciência de dados, análise em tempo real, business intelligence e relatórios. Saiba como iniciar uma avaliação gratuita!

Este artigo apresenta sugestões para solucionar problemas comuns do conector de REST no Azure Data Factory e no Azure Synapse.

Código de erro: RestSinkCallFailed

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

  • Causa: esse erro ocorre quando o pipeline do Data Factory ou do Synapse se comunica com o ponto de extremidade REST pelo protocolo HTTP e a operação de solicitação falha.

  • Recomendação: verifique o código de status HTTP ou a mensagem na mensagem de erro e corrija o problema do servidor remoto.

Código de erro: RestSourceCallFailed

  • Mensagem: The HttpStatusCode %statusCode; indicates failure.
Request URL: %requestUri;
Response payload:%payload;

  • Causa: esse erro ocorre quando o Azure Data Factory se comunica com o ponto de extremidade REST pelo protocolo HTTP e a operação de solicitação falha.

  • Recomendação: verifique o código de status HTTP, a URL de solicitação ou o conteúdo de resposta na mensagem de erro e corrija o problema do servidor remoto.

Código de erro: RestSinkUNSupportedCompressionType

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

  • Recomendação: verifique os tipos de compactação com suporte para o coletor REST.

Resposta de rede inesperada do conector REST

  • Sintomas: o ponto de extremidade às vezes recebe uma resposta inesperada (400, 401, 403, 500) do conector REST.

  • Causa: o conector de origem REST usa a URL e método/cabeçalho/corpo HTTP do serviço/conjunto de dados/fonte de cópia vinculado como parâmetros ao construir uma solicitação HTTP. O problema é provavelmente causado por alguns erros em um ou mais parâmetros especificados.

  • Resolução:

    • Use 'curl' em uma janela de Prompt de Comando para ver se o parâmetro é a causa (os cabeçalhos Aceitar e Agente do Usuário devem sempre ser incluídos):

      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>

      Se o comando retornar a mesma resposta inesperada, corrija os parâmetros anteriores com 'curl' até que ele retorne a resposta esperada.

      Você também pode usar 'curl--help' para um uso mais avançado do comando.

    • Se apenas o conector REST retornar uma resposta inesperada, entre em contato com o suporte da Microsoft para obter mais soluções de problemas.

    • Observe que 'curl' pode não ser adequado para reproduzir um problema de validação de certificado SSL. Em alguns cenários, o comando 'curl' foi executado com êxito sem encontrar nenhum problema de validação de certificado SSL. Mas quando o mesmo URL é executado em um navegador, nenhum certificado SSL é realmente retornado para o cliente estabelecer confiança com o servidor.

      Ferramentas como Postman e Fiddler são recomendadas para o caso anterior.

Para obter mais ajuda com a solução de problemas, experimente estes recursos: